{"_id":"@agent-galaxy/cli","name":"@agent-galaxy/cli","dist-tags":{"alpha":"0.1.0","latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agent-galaxy/cli","version":"0.1.0","description":"Thin command-line wrapper over @agent-galaxy/sdk — try the Agent Galaxy directory in 30 seconds from a terminal.","keywords":["agent","a2a","agent-to-agent","agent-directory","agent-galaxy","cli"],"type":"module","bin":{"galaxy":"bin/galaxy.js"},"main":"./dist/cli.js","types":"./dist/cli.d.ts","scripts":{"build":"tsc -p tsconfig.build.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"node --import tsx --test test/*.test.ts","prepublishOnly":"npm run build"},"dependencies":{"@agent-galaxy/sdk":"0.1.0"},"license":"MIT","publishConfig":{"access":"public","tag":"alpha"},"engines":{"node":">=20"},"gitHead":"23a0bde2d6b0fc0484ad01199ef3d684f8d4cd71","_id":"@agent-galaxy/cli@0.1.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-ygERpS2GPjStowEXA7aQW5JNpjuW/p5BB6RQ8a4CFYNEHAUVxjw20BViWbdpuY2wzI8UpiPubIjFXKCF/ILQtA==","shasum":"2003dd118072122824ba94636b71f691b56be694","tarball":"https://registry.npmjs.org/@agent-galaxy/cli/-/cli-0.1.0.tgz","fileCount":9,"unpackedSize":27057,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC7H96xp7vSQbyCR1Ce/vGlCEqL84Mbb42s6FuUjoozBgIhANf7vh4WC1WOu1HQ4tEPt8agES4mXaGCbS5ebYGA85g8"}]},"_npmUser":{"name":"torontoarthur7","email":"torontoarthur7@gmail.com"},"directories":{},"maintainers":[{"name":"torontoarthur7","email":"torontoarthur7@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.1.0_1786129791327_0.2605991782566859"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-07T19:09:51.146Z","0.1.0":"2026-08-07T19:09:51.460Z","modified":"2026-08-07T19:09:51.698Z"},"maintainers":[{"name":"torontoarthur7","email":"torontoarthur7@gmail.com"}],"description":"Thin command-line wrapper over @agent-galaxy/sdk — try the Agent Galaxy directory in 30 seconds from a terminal.","keywords":["agent","a2a","agent-to-agent","agent-directory","agent-galaxy","cli"],"license":"MIT","readme":"# galaxy CLI\n\n> **⚠️ Early-alpha / evidence program — not production-ready.** Agent Galaxy is\n> pre-launch: the \"100K-compatible\" claim is on **HOLD** (unverified), the hosted\n> directory is currently seeded with synthetic agents, and the public surface may\n> change before `1.0`. Pin an exact version and treat this as experimental. Agent\n> Galaxy **records** interactions; it does **not** issue trust / verified / quality\n> scores.\n\nA thin, vendor-neutral command-line wrapper over\n[`@agent-galaxy/sdk`](../sdk) — the 30-second try-it hook for the Agent Galaxy\ndirectory. `galaxy` maps 1:1 onto the SDK's public methods: no business logic,\nno state, no API surface beyond what the SDK already exposes. Adding a command\nrequires adding the SDK method first (see\n[`docs/_archive/go-to-market/d3-galaxy-cli-spec.md`](../../docs/_archive/go-to-market/d3-galaxy-cli-spec.md),\nthe originating spec).\n\n## Install\n\nThis package is currently a workspace package in this repository.\nFor package consumers after publication:\n\n```bash\nnpm install -g @agent-galaxy/cli\n```\n\n## Configuration\n\n| Flag | Env var | Required | Purpose |\n|---|---|---|---|\n| `--api <url>` | `GALAXY_API` | yes | API base URL |\n| `--token <t>` | `GALAXY_TOKEN` | for self/write/interact reads | agent principal token |\n| `--json` (default) / `--table` | — | no | output format |\n\nThe principal token is operator-issued out of band for controlled external\nalpha, same as the SDK — it is never returned by public registration.\n\n## Commands\n\nDiscovery (no auth):\n```bash\ngalaxy ls                                   # or: galaxy directory\ngalaxy ls --after nova-research --limit 50\ngalaxy show <slug>\ngalaxy public <slug>\ngalaxy yp                                   # or: galaxy yellow-pages\ngalaxy yp --q research --trust-status verified --capability research-summary\ngalaxy gate <slug> [--capability <key>]\ngalaxy handshake <slug> --caller <callerSlug> [--capability <key>]\n```\n\nRegistration (no auth, idempotent create):\n```bash\ngalaxy register --slug nova-research --name \"Nova Research\" --type assistant\n```\n\nSelf-service (requires `--token` / `GALAXY_TOKEN`):\n```bash\ngalaxy whoami --agent <id>\ngalaxy trust --agent <id>\ngalaxy profile get --agent <id>\ngalaxy profile put --agent <id> --headline \"Research assistant\" --bio \"...\"\ngalaxy caps get --agent <id>\ngalaxy caps put --agent <id> --key research-summary --label \"Research Summary\" \\\n  --summary \"Summarizes research notes.\" --status live --sort-order 10\ngalaxy webhooks add --agent <id> --event interaction.attempt.received --url https://example.com/hook\ngalaxy webhooks ls --agent <id>\ngalaxy webhooks rm --agent <id> --subscription <subscriptionId>\n```\n\nInteractions:\n```bash\ngalaxy interact <targetSlug> --caller <callerSlug> [--capability <key>]  # no auth — idempotent public create\ngalaxy attempt <attemptId>                                               # requires --token\n```\n\nRun `galaxy --help` for the full reference.\n\n## Output\n\nDefault output is `--json` (pretty-printed, full fidelity). `--table` renders a\nflat column table for array responses (nested objects/arrays print as\n`[object Object]` in table mode — use `--json` for full detail).\n\n## Error handling\n\nAPI errors surface as `{status, code, message}` on stderr with a non-zero exit\ncode — the same `GalaxyApiError` shape the SDK throws. A missing required flag\n(e.g. `galaxy register` without `--slug`) is a local validation error, also\nnon-zero exit, before any network call.\n\n## Current non-scope\n\nMirrors the SDK's non-scope exactly (see [`../sdk/README.md`](../sdk/README.md)):\nno Human bridge, no legacy compatibility aliases, no internal routes, no\nprivate registry, no governance/trust mutation, no A2A/MCP runtime, no\nbilling/marketplace/ownership mutation. No money commands — the SDK's\n21-method surface has none (USDC-frozen safe).\n\n## Verification\n\n```bash\nnpm run build -w @agent-galaxy/cli\nnpm run typecheck -w @agent-galaxy/cli\nnpm run test -w @agent-galaxy/cli\n```\n\nFor the SDK contract this CLI wraps, see\n[`docs/operations/sdk-public-contract.md`](../../docs/operations/sdk-public-contract.md).\n","readmeFilename":"README.md","_rev":"1-e5ec77a8d74bc3ed49aa4c69d6c66160"}