@forgeax/cli
v0.1.15
Published
@forgeax/cli — self-contained single-agent runtime (agent loop, events, history, capability, provider, compaction). Embeddable natively; also implements the AgentKernel contract as a drop-in kernel.
Readme
@forgeax/cli
Terminal-native ForgeaX single-agent runtime: agent loop, tools, MCP, permissions, Ink TUI.
Docs: https://forgeax.github.io/docs/cli/overview
Install
npm install -g @forgeax/cli
# requires Node.js 18+Global commands: forgeax and forgeax-cli (alias).
Update
forgeax update # install @forgeax/cli@latest from npm
forgeax update --check # report only; do not installRequires a global npm install. Monorepo / project-local checkouts are refused with a manual hint.
Quick start
cd my-project
forgeax
forgeax -p "帮我优化这个函数"
forgeax --demo -p "hi" # no API keySet a provider key before non-demo runs (for example ANTHROPIC_API_KEY).
Forms
| Form | How |
|:--|:--|
| CLI / TUI | forgeax / forgeax -p "..." |
| Sidecar | forgeax --serve --sock <path> (Studio / orchestrator) |
| Library | import { createAgent } from '@forgeax/cli' (types / API stability later) |
Monorepo note
Inside forgeax-os this package lives at packages/cli. Studio kernel id remains forgeax-core (env / registry), independent of the npm name @forgeax/cli.
