adom-cli

⋯ 1 unchanged line ⋯

@@ -1,8 +1,9 @@ {   "slug": "adom-cli",-  "version": "4.0.1",+  "version": "4.0.3",   "type": "app",   "org": "adom",+  "org_id": "681d18d2a224243b0d62c9b2",   "description": "Adom CLI — platform binary for containers, repos, workspaces, orgs, SSH keys, Hydrogen settings, and more",   "dependencies": {},   "scripts": {@@ -12,5 +13,46 @@   "hero": {     "type": "image",     "path": "screenshots/hero.png"-  }+  },+  "bundled": true,+  "tags": [+    "cli",+    "platform",+    "containers",+    "repos",+    "orgs",+    "ssh-keys",+    "hydrogen",+    "carbon"+  ],+  "discovery_pitch": "Drive the Adom platform from the terminal: containers, repos, orgs, SSH keys, and Hydrogen panels.",+  "discovery_triggers": [+    "list my containers",+    "create a container",+    "ssh into a container",+    "resize a container",+    "expose a port from my container",+    "list my repos",+    "add an ssh key",+    "open a hydrogen tab",+    "what containers do i have"+  ],+  "sample_prompts": [+    {+      "label": "List containers",+      "prompt": "list my adom containers"+    },+    {+      "label": "New container",+      "prompt": "create a small container for this repo"+    },+    {+      "label": "Expose a port",+      "prompt": "expose port 5173 from my container so I can see the dev server"+    },+    {+      "label": "SSH keys",+      "prompt": "add my ssh key to my adom account"+    }+  ] }\ No newline at end of file

@@ -1,6 +1,6 @@ {   "slug": "adom-cli",-  "version": "4.0.2",+  "version": "4.0.3",   "type": "app",   "org": "adom",   "description": "Adom CLI — platform binary for containers, repos, workspaces, orgs, SSH keys, Hydrogen settings, and more",@@ -17,5 +17,46 @@   "author": {     "name": "Kyle Bergstedt",     "email": "[email protected]"-  }+  },+  "bundled": true,+  "tags": [+    "cli",+    "platform",+    "containers",+    "repos",+    "orgs",+    "ssh-keys",+    "hydrogen",+    "carbon"+  ],+  "discovery_pitch": "Drive the Adom platform from the terminal: containers, repos, orgs, SSH keys, and Hydrogen panels.",+  "discovery_triggers": [+    "list my containers",+    "create a container",+    "ssh into a container",+    "resize a container",+    "expose a port from my container",+    "list my repos",+    "add an ssh key",+    "open a hydrogen tab",+    "what containers do i have"+  ],+  "sample_prompts": [+    {+      "label": "List containers",+      "prompt": "list my adom containers"+    },+    {+      "label": "New container",+      "prompt": "create a small container for this repo"+    },+    {+      "label": "Expose a port",+      "prompt": "expose port 5173 from my container so I can see the dev server"+    },+    {+      "label": "SSH keys",+      "prompt": "add my ssh key to my adom account"+    }+  ] }\ No newline at end of file

@@ -19,10 +19,29 @@ adom-cli carbon containers list-for-repo adom-cli carbon containers list-for-repo kcknox other-repo ``` +## Listing is paged: never read one page as "all of them"++`carbon containers list` returns ONE page (25 by default). When a full page comes+back it prints a hint saying there are probably more. Heed it: a container that+exists but sits on page 2 is invisible to page 1, and reading that as "no such+container" is a wrong answer, not a missing one. It has already happened.++```bash+adom-cli carbon containers list              # page 1 + a hint if there may be more+adom-cli carbon containers list --page 2     # the next page+adom-cli carbon containers list --all        # every page, merged (prints everything)+adom-cli carbon containers list --class small   # narrow instead of paging+```++Prefer `--class`, or `get <slug>` when you already know the slug, over `--all`:+`--all` prints every record and is the expensive way to answer "is X there?".+ ## When to use  - User asks "what containers does this repo have?" -> `adom-cli carbon containers list-for-repo`-- User asks "list my containers" or "show all my containers" -> `adom-cli carbon containers list`+- User asks "list my containers" -> `adom-cli carbon containers list` (one page)+- User asks "show ALL my containers", or you must not miss one -> `adom-cli carbon containers list --all`+- Looking for a specific container -> `adom-cli carbon containers get <slug>`, not a list scan - User wants to create, inspect, resize, or list containers - User needs to expose a port from a container (port mappings) - User asks about available container images or sizes