Command-line interface for creating and managing AI agents.
Install globally:
npm install -g @agentage/cli
Or use with npx:
npx @agentage/cli <command>
# Create a new agent agent init my-assistant # Run the agent agent run my-assistant "Hello, how are you?" # List all agents agent list
Create a new agent configuration file.
# Create agent with default name agent init # Create agent with custom name agent init my-assistant # Create in global directory agent init my-agent --global
Execute an agent with a prompt.
# Run with default prompt agent run my-assistant # Run with custom prompt agent run my-assistant "What is TypeScript?"
List all available agents (local and global).
agent list
Publish an agent to the Agentage registry.
# Publish agent in current directory agent publish # Publish specific agent file agent publish agents/my-agent.agent.md # Dry run (validate without publishing) agent publish --dry-run
Install an agent from the registry.
# Install latest version agent install user/my-agent # Install specific version agent install user/my-agent@2025年01月01日 # Install globally agent install user/my-agent --global
Search for agents in the registry.
# Search for agents agent search "code review" # Limit results agent search "ai assistant" --limit 5
Authenticate with the Agentage registry.
agent login
Log out from the registry.
agent logoutDisplay the currently logged in user.
agent whoami
Update the CLI to the latest version.
agent update
- Node.js >= 20.0.0
- npm >= 10.0.0
# Install dependencies npm install # Run in development mode npm run dev # Build npm run build # Run tests npm test # Run tests with coverage npm run test:coverage # Lint npm run lint # Type check npm run type-check # Full verification (type-check, lint, build, test) npm run verify
cli/
├── src/
│ ├── cli.ts # CLI entry point
│ ├── index.ts # Package exports
│ ├── commands/ # CLI command handlers
│ │ ├── init.ts
│ │ ├── run.ts
│ │ ├── list.ts
│ │ ├── publish.ts
│ │ ├── install.ts
│ │ ├── search.ts
│ │ ├── login.ts
│ │ ├── logout.ts
│ │ ├── whoami.ts
│ │ └── update.ts
│ ├── services/ # API services
│ │ ├── auth.service.ts
│ │ └── registry.service.ts
│ ├── utils/ # Utility functions
│ │ ├── agent-parser.ts
│ │ ├── config.ts
│ │ ├── lockfile.ts
│ │ └── version.ts
│ ├── schemas/ # Zod schemas
│ │ └── agent.schema.ts
│ ├── types/ # TypeScript types
│ │ ├── config.types.ts
│ │ ├── lockfile.types.ts
│ │ └── registry.types.ts
│ └── __mocks__/ # Jest mocks
│ └── chalk.ts
├── package.json
├── tsconfig.json
├── jest.config.js
├── eslint.config.js
└── README.md
MIT