agentforge

AgentForge is a TypeScript monorepo for building and operating self-hosted AI agents with a persistent Mastra runtime, a Convex-backed data layer, and CLI-driven local workflows.

The repository currently contains the framework packages, the local Convex app used during development, the default project template scaffolded by the CLI, and example projects.

agentforge/
├── packages/
│   ├── cli/                   # agentforge CLI and project scaffolding
│   ├── runtime/               # Persistent Mastra daemon and channel adapters
│   ├── core/                  # Shared agent, sandbox, MCP, channel, A2A, voice primitives
│   └── web/                   # Standalone dashboard package
├── convex/                    # Local Convex app copy used in repo development
├── templates/default/         # Synced default project template assets
├── examples/finforge/         # Example project
├── docs/                      # Project documentation
└── tests/e2e/                 # End-to-end test suite

The scaffolded project template source of truth lives under `packages/cli/templates/default/`, and Convex template changes must stay synced with the generated copies.

• @agentforge-ai/cli: scaffolds projects and provides the operational commands used during local development.
• @agentforge-ai/runtime: exports the daemon, agent factory, Convex-backed memory helpers, and HTTP/Discord/Telegram channel adapters.
• @agentforge-ai/core: exports shared agent primitives, sandboxing, MCP, channels, skills, A2A, research, workflows, voice, and browser tooling.
• @agentforge-ai/web: a package-specific dashboard app.
• convex/: the repo’s local Convex backend copy, which mirrors the default template’s Convex layer.

The CLI currently registers these command families from `packages/cli/src/index.ts`:

• Project lifecycle: create, run, `