Polish sandbox process UX and remove skills command

Author: BhautikChudasama

CLAUDE.md

@@ -53,13 +53,12 @@ private helper, test-only — is **not** a shared surface, so skip the mesh for
 cmd/
   auth/        login, logout, whoami commands
   projects/    projects subcommands (list, get, delete)
-  skills/      skills subcommands (catalog, purchased)
   root/        app wiring, Before hook, default action
 internal/
   api/         resty client, types, all API methods
   config/      token storage (~/.createos/.token)
   intro/       ASCII banner
-  ui/          interactive TUI components (skills catalog)
+  ui/          interactive TUI components
 main.go        entry point — error display only
 ```
 

README.md

@@ -10,7 +10,7 @@
   Your intelligent infrastructure CLI
 ```
 
-The official command-line interface for [CreateOS](https://createos.nodeops.network?utm_source=createos-cli) — manage your projects and skills from the terminal.
+The official command-line interface for [CreateOS](https://createos.nodeops.network?utm_source=createos-cli) — manage your projects from the terminal.
 
 ## Installation
 
@@ -338,7 +338,7 @@ Use `sandbox exec` for quick non-interactive one-shot commands. Use `sandbox she
 | `createos sandbox process start <sb> -- <cmd>` | Start a managed command and print its process ID           |
 | `createos sandbox process shell <sb>`        | Start a persistent shell session that can be reattached      |
 | `createos sandbox process attach <sb> <proc>` | Reconnect to process output or a shell session              |
-| `createos sandbox process attach <sb>`       | Pick a running shell session and attach/switch to it         |
+| `createos sandbox process attach <sb>`       | Pick a running process or shell session and attach to it     |
 | `createos sandbox process list <sb>`         | List managed processes and shell sessions                    |
 | `createos sandbox process get <sb> <proc>`   | Show details for one managed process                         |
 | `createos sandbox process input <sb> <proc>` | Write input to a process or shell session                    |
@@ -348,7 +348,7 @@ Use `sandbox exec` for quick non-interactive one-shot commands. Use `sandbox she
 | `createos sandbox process wait <sb> <proc>`  | Wait for a managed process to exit                           |
 | `createos sandbox process stop <sb> <proc>`  | Stop a process and anything it started                       |
 
-Managed shell attach shortcuts are fixed: `Ctrl-]` detaches, `Ctrl-N` creates a new shell and switches to it, and `Ctrl-P` picks another running shell session.
+Interactive attach without a process ID shows running managed processes. Pick a PTY shell for an interactive terminal, or pick a pipe process to follow its stdout/stderr output. Managed shell shortcuts are fixed: `Ctrl-]` detaches, `Ctrl-N` creates a new shell and switches to it, and `Ctrl-P` opens the process picker.
 
 **Sandbox sub-resource commands:**
 
@@ -386,13 +386,6 @@ Managed shell attach shortcuts are fixed: `Ctrl-]` detaches, `Ctrl-N` creates a
 | `createos webhooks suspend`   | Suspend a webhook endpoint         |
 | `createos webhooks resume`    | Resume a suspended webhook endpoint|
 
-### Skills
-
-| Command                     | Description                |
-| --------------------------- | -------------------------- |
-| `createos skills catalog`   | Browse the skills catalog  |
-| `createos skills purchased` | List your purchased skills |
-
 ### Quick Actions
 
 | Command           | Description                                      |
@@ -520,15 +513,15 @@ createos sandbox process run my-box -- npm test
 createos sandbox process start my-box -- python -m http.server 8000
 createos sandbox process shell my-box
 createos sandbox process attach my-box proc_abc123
-createos sandbox process attach my-box        # pick a running shell session
+createos sandbox process attach my-box        # pick a running process or shell session
 createos sandbox process ps my-box
 createos sandbox process input my-box proc_abc123 --text "hello\n"
 createos sandbox process signal my-box proc_abc123 SIGINT
 createos sandbox process wait my-box proc_abc123 --all
 createos sandbox process stop my-box proc_abc123 --grace 1s
 # Inside a managed shell session, the fixed bottom bar shows active shortcuts.
 # detach closes the local attach; new creates a shell and switches;
-# switch picks another shell; `exit` closes the current shell.
+# switch opens the process picker; `exit` closes the current shell.
 createos sandbox push my-box ./script.py /root/script.py
 createos sandbox pull my-box /root/output.csv ./output.csv
 createos sandbox tunnel my-box --local 8080 --remote 8000
@@ -638,7 +631,7 @@ createos environments list --project <id> -o json
 | `--output, -o <fmt>`     | Output format: `json` or `table` (default). Auto-json when piped.   |
 | `--debug, -d`            | Print HTTP request/response details (token is masked)                |
 | `--api-url`              | Override the API base URL                                            |
-| `--sandbox-api-url`      | Override the sandbox (fc-spawn) base URL                             |
+| `--sandbox-api-url`      | Override the sandbox API base URL                                    |
 | `--sandbox-gateway`      | SSH gateway address (`host:port`) used by `sandbox shell --ssh`      |
 
 ## Security

cmd/ask/agent.md

@@ -23,7 +23,6 @@ Use the `bash` tool to run `createos` commands on behalf of the user. Always run
 - `createos vms` — Deploy, list, get, resize, ssh, reboot, terminate VM instances (`--vm <id>`)
 - `createos oauth-clients` — List, create, get instructions, delete OAuth clients (`--client <id>`)
 - `createos me` — List and revoke OAuth consents (`--client <id>`)
-- `createos skills` — Browse and list purchased skills
 - `createos init` — Link the current directory to a project
 - `createos status` — Show a project's health and deployment status
 - `createos open` — Open a project's live URL in the browser

cmd/root/root.go

@@ -22,7 +22,6 @@ import (
 	"github.com/NodeOps-app/createos-cli/cmd/projects"
 	"github.com/NodeOps-app/createos-cli/cmd/sandbox"
 	"github.com/NodeOps-app/createos-cli/cmd/scale"
-	"github.com/NodeOps-app/createos-cli/cmd/skills"
 	"github.com/NodeOps-app/createos-cli/cmd/status"
 	"github.com/NodeOps-app/createos-cli/cmd/templates"
 	"github.com/NodeOps-app/createos-cli/cmd/upgrade"
@@ -62,7 +61,7 @@ func NewApp() *cli.App {
 			},
 			&cli.StringFlag{
 				Name:    "sandbox-api-url",
-				Usage:   "Override the sandbox (fc-spawn) base URL",
+				Usage:   "Override the sandbox API base URL",
 				EnvVars: []string{"CREATEOS_SANDBOX_URL"},
 				Value:   api.DefaultSandboxBaseURL,
 			},
@@ -182,7 +181,6 @@ func NewApp() *cli.App {
 				fmt.Println("  projects       Manage projects")
 				fmt.Println("  sandbox        Manage sandboxes")
 				fmt.Println("  scale          Adjust replicas and resources")
-				fmt.Println("  skills         Manage skills")
 				fmt.Println("  status         Show project health and deployment status")
 				fmt.Println("  templates      Browse and scaffold from project templates")
 				fmt.Println("  vms            Manage VM terminal instances")
@@ -219,7 +217,6 @@ func NewApp() *cli.App {
 			projects.NewProjectsCommand(),
 			sandbox.NewSandboxCommand(),
 			scale.NewScaleCommand(),
-			skills.NewSkillsCommand(),
 			status.NewStatusCommand(),
 			templates.NewTemplatesCommand(),
 			upgrade.NewUpgradeCommand(),
@@ -230,10 +227,38 @@ func NewApp() *cli.App {
 			versioncmd.NewVersionCommand(),
 		},
 	}
+	installTrailingHelpGuards(app.Commands)
 
 	return app
 }
 
+func installTrailingHelpGuards(commands []*cli.Command) {
+	for _, cmd := range commands {
+		if cmd == nil {
+			continue
+		}
+		if cmd.Action != nil {
+			original := cmd.Action
+			cmd.Action = func(c *cli.Context) error {
+				if argsRequestHelp(c) {
+					return cli.ShowSubcommandHelp(c)
+				}
+				return original(c)
+			}
+		}
+		installTrailingHelpGuards(cmd.Subcommands)
+	}
+}
+
+func argsRequestHelp(c *cli.Context) bool {
+	for _, arg := range c.Args().Slice() {
+		if arg == "-h" || arg == "--help" || arg == "help" {
+			return true
+		}
+	}
+	return false
+}
+
 // refreshOAuthSession exchanges the session's refresh token for a new
 // access token, updates the session in place, and persists it to
 // ~/.createos/.oauth. It returns the new access token. This is shared by

cmd/sandbox/create.go

@@ -19,7 +19,7 @@ func newCreateCommand() *cli.Command {
 		Aliases:   []string{"c"},
 		Usage:     "Create a new sandbox",
 		ArgsUsage: " ",
-		Description: `Create a new sandbox on fc-spawn.
+		Description: `Create a new sandbox.
 
 Examples:
   # Smallest possible sandbox