CLI tool for AgentForge - scaffolding, development, and deployment
npm install @agentforge/cli> CLI tool for AgentForge - scaffolding, development, testing, and deployment
156 tests passing | 98.11% coverage | 13 commands | 4 project templates
``bashGlobal installation (recommended)
npm install -g @agentforge/cli
āØ Features
- š Project Scaffolding - 4 templates (minimal, full, api, cli)
- š ļø Development Tools - Dev server, build, test commands
- š¦ Deployment - Deploy to Docker, Kubernetes, cloud platforms
- š§ Code Generation - Generate agents, tools, middleware
- ā
Validation - Project structure and configuration validation
- š Diagnostics - Health checks and issue detection
- š Upgrades - Dependency and framework upgrades
- š Configuration - Manage project settings
Commands
$3
####
Create a new AgentForge project with interactive setup.
bash
agentforge create my-projectWith options
agentforge create my-project --template full --package-manager pnpm
`Options:
-
- Project template (minimal, full, api, cli) [default: minimal]
- -p, --package-manager - Package manager (npm, pnpm, yarn) [default: pnpm]
- --no-install - Skip dependency installation
- --no-git - Skip git initialization$3
####
devStart development server with hot reload.
bash
agentforge devWith options
agentforge dev --port 4000
`Options:
-
- Port number [default: 3000]
- --no-open - Do not open browser####
buildBuild for production.
bash
agentforge buildWith options
agentforge build --no-minify --no-sourcemap
`Options:
-
- Skip minification
- --no-sourcemap - Skip sourcemap generation####
testRun tests with coverage.
bash
agentforge testWith options
agentforge test --watch
agentforge test --ui
agentforge test --coverage
`Options:
-
- Watch mode
- --ui - Open test UI
- --coverage - Generate coverage report####
lintLint and format code.
bash
agentforge lintWith options
agentforge lint --fix
`Options:
-
- Auto-fix issues
- --no-format - Skip formatting$3
####
agent:create Create a new agent.
bash
agentforge agent:create myAgentWith options
agentforge agent:create myAgent --pattern plan-execute
`Options:
-
- Agent pattern (react, plan-execute, reflection, multi-agent) [default: react]
- --no-test - Skip test generation####
agent:create-reusable Create a new reusable agent using the production template.
This command scaffolds a complete reusable agent with:
- Factory function pattern
- External prompt templates (
files)
- Tool injection support
- Feature flags
- Configuration validation with Zod
- Comprehensive test suite
- Full documentation`bash
agentforge agent:create-reusable customer-supportWith options
agentforge agent:create-reusable data-analyst --description "Analyze data and generate insights" --author "Your Name"
`Options:
-
- Agent description
- -a, --author - Author nameWhat Gets Created:
`
customer-support/
āāā src/
ā āāā index.ts # Agent factory function
ā āāā index.test.ts # Comprehensive tests
āāā prompts/
ā āāā system.md # External prompt template
āāā package.json
āāā tsconfig.json
āāā vitest.config.ts
āāā README.md
Note: The agent uses
from @agentforge/core for secure prompt template loading with built-in injection protection.Next Steps After Creation:
1.
cd customer-support
2.
3. Edit to customize the prompt
4. Edit src/index.ts to add tools and configuration
5. pnpm test to run tests
6. pnpm build to buildSee Also:
- Vertical Agents Guide
- Example Vertical Agents
####
agent:listList all agents.
bash
agentforge agent:listWith verbose output
agentforge agent:list --verbose
`Options:
-
- Show detailed information####
agent:test Test a specific agent.
bash
agentforge agent:test myAgentWith watch mode
agentforge agent:test myAgent --watch
`Options:
-
- Watch mode####
agent:deploy Deploy an agent.
bash
agentforge agent:deploy myAgentWith options
agentforge agent:deploy myAgent --environment staging --dry-run
`Options:
-
- Deployment environment [default: production]
- --dry-run - Dry run without actual deployment$3
####
tool:create Create a new tool.
bash
agentforge tool:create myToolWith options
agentforge tool:create myTool --category web
`Options:
-
- Tool category (web, data, file, utility) [default: utility]
- --no-test - Skip test generation####
tool:listList all tools.
bash
agentforge tool:listFilter by category
agentforge tool:list --category web --verbose
`Options:
-
- Filter by category
- -v, --verbose - Show detailed information####
tool:test Test a specific tool.
bash
agentforge tool:test myToolWith watch mode
agentforge tool:test myTool --watch
`Options:
-
- Watch mode####
tool:publish Publish a tool to npm.
bash
agentforge tool:publish myToolWith options
agentforge tool:publish myTool --tag beta --dry-run
`Options:
-
- npm tag [default: latest]
- --dry-run` - Dry run without actual publishing- š Full Documentation
- š Quick Start
- š ļø CLI API Reference
- š” Getting Started Tutorial
- GitHub Repository
- npm Package
- Changelog - See what's new before upgrading
- Report Issues
- @agentforge/core - Core abstractions
- @agentforge/patterns - Agent patterns
- @agentforge/tools - Standard tools
- @agentforge/testing - Testing utilities
MIT Ā© 2026 Tom Van Schoor