Agent Store CLI

Agent Store CLI lets local coding agents such as Claude Code and Codex deploy a local project to Agent Store with a short natural-language request.

Install

npm install -g @mars-tec/agent-store-cli@latest
agent-store skill install

Then start a new chat in your coding agent and say:

帮我部署一下

For the first deployment, the agent should ask you to confirm:

• the project English name, also called appSlug
• whether the app needs a platform-managed MySQL database

For later deployments in the same project directory, the agent should reuse .agent-store/config.json and redeploy the existing Agent Store project.

Login

agent-store login
agent-store whoami

The token is stored in ~/.agent-store/config.json.

Common Commands

agent-store doctor
agent-store deploy --create --slug my-app --yes
agent-store deploy --create --slug my-app --with-db --yes
agent-store deploy --create --slug my-app --yes --set NODE_ENV=production
agent-store prepare --env prod --env-file .agent-store/env.prod
agent-store status
agent-store redeploy
agent-store unlink
agent-store diagnose

--set KEY=value and --env-file <path> are useful for non-interactive agents and CI-like runs. Repeated --set and repeated --env-file are supported. Values passed this way are saved into the Agent Store environment config and are not printed by the CLI.

If the local .agent-store/config.json points to a deleted or inaccessible app, run:

agent-store unlink

Then run the first-deploy command again with --create.

Skill

The npm package includes the Agent Store skill at:

skills/agent-store-cli/SKILL.md

Install it with:

agent-store skill install

The skill teaches the coding agent to:

• check login with agent-store whoami
• check project binding with agent-store status
• ask for first-deploy confirmation before creating an app
• run agent-store doctor
• deploy or redeploy through the CLI
• pass required environment variables with --set or --env-file
• recover from stale project binding with agent-store unlink
• pull raw failed logs with agent-store diagnose
• explain the issue before modifying local code

During build or deployment, the CLI streams logs first and then falls back to polling the platform record status if the log stream is truncated or closes early. This avoids treating an already successful platform task as failed only because the live log stream was incomplete.

Website Setup Guide

For beginner-friendly installation, ask your coding agent to read:

https://agent-store.shanliang365.com/skill-setup.md

Requirements

• Node.js 18 or newer
• npm
• an Agent Store account