@innocarpe/carpeos
v6.7.7
Published
CarpeOS CLI and local MCP server — capture context, compound knowledge.
Downloads
5,426
Maintainers
Readme
@innocarpe/carpeos
CarpeOS CLI and local MCP server: capture agent context, store provenance-aware knowledge, and retrieve it for humans and agents.
Install
# npm — current public release
npm install -g @innocarpe/[email protected]
# one-liner (curl)
curl -fsSL https://raw.githubusercontent.com/innocarpe/carpeos/main/scripts/install.sh | bashRequires Node.js ≥ 22.22.
The current public release is 6.7.7 (grounded extract cite belt + agentic quality substrate + HITL-free Agentic Layer with
deepseek-v4-flash product path, plus agentic feed / flush). Activate with
the exact version pin and carpeos setup doctor. Always-on Flash batch:
carpeos agentic timer install. Versions follow
SemVer. See the repo
CHANGELOG and
versioning policy.
First-time machine setup
Global install puts carpeos and carpeos-mcp-server on your PATH. Then
configure the private runtime and register MCP with agent hosts:
carpeos setup --help # full parameter interface
carpeos setup plan # see resolved paths + actions (no changes)
carpeos setup run --apply # apply defaults
carpeos setup doctor # verify
carpeos setup show # print saved configOptions include --home, --bin-dir, --workspace-root, --trust-zone, and
--register-mcp auto|none|claude,codex,grok. Setup never mutates the machine
without --apply.
This creates ~/.carpeos, installs convenience wrappers under ~/.local/bin
(if needed), and registers the CarpeOS MCP server with Claude Code, Codex CLI,
and Grok Build when those tools are available.
Quick use
carpeos --help # full CLI surface
carpeos version # package name + version (JSON)
carpeos help agentic # post-capture HITL-free brain
carpeos help memory # retrieval
carpeos init --home "$HOME/.carpeos" --trust-zone tz_local_default
carpeos agentic run --once --materialize
carpeos memory context-pack \
--task "Summarize my current work" \
--trust-zone tz_local_default \
--visible-trust-zone tz_local_defaultThe B0 reconcile-policy command is a metadata-only preview. Its supported
flags are exactly --from-policy, --to-policy, --trust-zone, and --limit.
--apply, --apply-safe-subset, acknowledgements, receipts, and Supersession
construction are unavailable; B1 write/apply/receipt work is deferred.
adj_v3 is precision-first and session-de-noising; held review remains
policy-aware and append-only. Neither adjudication path automatically creates a
Claim or an AcceptanceDecision. The adjudication and knowledge-form
evaluators are evidence-only, the retrieval evaluator is synthetic, and dogfood
uses only synthetic, disposable evidence.
Docs
- Repository: https://github.com/innocarpe/carpeos
- One-stop install (git checkout):
docs/guides/one-stop-install.md - MCP guide:
docs/guides/mcp-server.md - OKF export guide
License
Apache-2.0
