Command-line interface for creating and managing AI agents.
Install globally:
npm install -g @agentage/cliOr 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 listCreate 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 --globalExecute 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 listPublish 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-runInstall 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 --globalSearch for agents in the registry.
# Search for agents
agent search "code review"
# Limit results
agent search "ai assistant" --limit 5Authenticate with the Agentage registry.
agent loginLog out from the registry.
agent logoutDisplay the currently logged in user.
agent whoamiUpdate 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 verifycli/
├── 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