CLI

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 via NO_COLOR env).
--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 push

`validate`

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 1165ms

`push`

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-0f88d28e5a01

`list`

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.

← Process de validation Monétisation →