CLI reference
The @agentstore/cli npm package is the primary interface for building, testing and publishing agents from your local machine or CI. Run agentstore help to see the full list of commands.
Global flags
--no-color— disable ANSI colours (also honoured viaNO_COLORenv).--help,-h— show help for the command.
Configuration
CLI state lives under ~/.agentstore/:
config.json—apiUrl,portalUrl.credentials.json— access + refresh tokens (600 perms).
Override the API base via AGENTSTORE_API_URL in your environment.
init
Scaffold a new agent directory with a Hello-World agent.yaml template, a `.agentstore/` local config and a `.gitignore`.
agentstore init <name>
$ agentstore init my-agent
✓ Scaffolded agent: my-agent
Files created:
agent.yaml Manifest template
.agentstore/ Local config
.gitignore Credentials ignore list
Next steps:
$ cd my-agent
$ agentstore validate
$ agentstore test
$ agentstore pushvalidate
Validate the manifest schema, variable references, per-block constraints, and compute the quality score without any API call. Exit code 1 if errors are present.
agentstore validate [path]
$ agentstore validate
source: ./agent.yaml
✓ Schema YAML parsable
✓ System prompt : 214 caractères
✓ Input blocks : 3
✓ Output mode : structured (3 blocks)
✓ Test fixtures : 1
⚠ short_description — below optimal length (< 50 chars)
Score qualité : 74/100 — auto-approve
✓ Manifest valide. Prêt pour `agentstore push`.test
Run each declared test fixture against the /v1/playground/run endpoint. Verifies `expected_output_contains`. Falls back to a dry-run (prompt resolution only) when the backend is unreachable.
agentstore test [path] [--fixture <name>] [--dry-run]
| Flag | Description |
|---|---|
--fixture <name> | Run a single fixture by name. |
--dry-run | Resolve the template locally — no API call. |
$ agentstore test
Running 2 fixture(s)…
✓ senior_frontend (1342ms)
✓ junior_role (988ms)
2/2 tests passés — avg latency 1165mspush
Validate + submit the agent to /v1/creator/agents. Prints the verdict (AUTO_APPROVE / IN_REVIEW / REJECT) and the submission id. Prompts for confirmation unless --yes is set.
agentstore push [path] [--message <msg>] [--dry-run] [--yes]
| Flag | Description |
|---|---|
--message <msg> | Changelog message attached to the submission. |
--dry-run | Show the summary without sending. |
--yes, -y | Skip the confirmation prompt. |
$ agentstore push --message "Add budget chart"
Résumé :
Nom : ResumeForge
Version : 1.1.0
Catégorie : productivity
Pricing : ONE_SHOT @ 2.99€
Score : 82/100
Soumettre ResumeForge v1.1.0 ? (y/N) y
⇢ Uploading manifest…
✓ Auto-approuvé ! Visible sur le store dans quelques minutes.
Submission ID: 7b2a09e4-1f7d-4c0b-a2b5-0f88d28e5a01list
List the agents owned by the authenticated creator with status, total runs, rating and monthly revenue.
agentstore list
$ agentstore list
Agent Version Statut Runs Note Revenus
────────────────────────────────────────────────────────────────────────────────
ResumeForge 1.2.0 ● PUBLISHED 12 478 4.8★ 684€
EmailCraft 1.1.0 ● IN_REVIEW 2 847 4.6★ 112€
TravelPlanner 0.1.0 ● DRAFT — — —status
Detailed status of an agent. If no slug is passed, infers it from the manifest in the current directory.
agentstore status [slug]
$ agentstore status resume-forge
Agent : ResumeForge
Version : 1.2.0
Statut : ● PUBLISHED ✓
Publié : 01/04/2026
Runs : 12 478
Note : 4.8★ (247 avis)login
Authenticate against your creator account. Interactive (email + password prompt) or headless (--token) for CI usage.
agentstore login [--email <e>] [--password <p>] [--token <jwt>]
| Flag | Description |
|---|---|
--token <jwt> | Skip interactive login with a pre-issued JWT (useful for CI). |
$ agentstore login
email: [email protected]
password: ********
✓ Connecté en tant que Alex Dubois ([email protected])logout
Clear cached tokens from ~/.agentstore/credentials.json.
agentstore logout
$ agentstore logout
✓ Tokens cleared.