{"_id":"@aigentic/cli-core","_rev":"2-9f1988821e131bd4cf5c8d1cf34bacda","name":"@aigentic/cli-core","dist-tags":{"alpha":"3.7.0-alpha.5","latest":"3.7.0-alpha.5"},"versions":{"3.7.0-alpha.5":{"name":"@aigentic/cli-core","version":"3.7.0-alpha.5","keywords":["claude-flow","cli","core","lite","lazy-load","mcp","memory","hooks"],"author":{"url":"https://github.com/ruvnet","name":"ruvnet"},"license":"MIT","_id":"@aigentic/cli-core@3.7.0-alpha.5","maintainers":[{"name":"aigentic","email":"engineering@aigentic.net"}],"homepage":"https://github.com/ruvnet/ruflo","bugs":{"url":"https://github.com/ruvnet/ruflo/issues"},"bin":{"claude-flow-core":"dist/src/index.js"},"dist":{"shasum":"f5c494d313ba8f121009f4244591d0a7ac4ab25d","tarball":"https://registry.npmjs.org/@aigentic/cli-core/-/cli-core-3.7.0-alpha.5.tgz","fileCount":2,"integrity":"sha512-YUyE8fh5A7CfUIav6D/Pn1qta1GVAT9Dgts7daUyLYZOqvA7ou3P0XBginERunf+SxirC/GnRPTMF/WbaHvkzg==","signatures":[{"sig":"MEUCIAED2gG/Z+w2TqYvGr7fWefrZU+6M7EX+ImTbBCRXw4wAiEAg54/vv4F7XcFpA2JfGrYmCVrBvZYK6TCUzhGPDipOEM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5448},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","exports":{".":"./dist/src/index.js","./types":"./dist/src/types.js","./memory":"./dist/src/memory/backend.js","./output":"./dist/src/output.js","./mcp-tools":"./dist/src/mcp-tools/index.js","./commands/memory":"./dist/src/commands/memory.js","./mcp-tools/types":"./dist/src/mcp-tools/types.js","./memory/json-backend":"./dist/src/memory/json-backend.js","./mcp-tools/hooks-defs":"./dist/src/mcp-tools/hooks-defs.js","./mcp-tools/memory-defs":"./dist/src/mcp-tools/memory-defs.js","./mcp-tools/validate-input":"./dist/src/mcp-tools/validate-input.js"},"scripts":{"test":"vitest run","build":"tsc"},"_npmUser":{"name":"aigentic","email":"engineering@aigentic.net"},"repository":{"url":"git+https://github.com/ruvnet/ruflo.git","type":"git","directory":"v3/@claude-flow/cli-core"},"_npmVersion":"11.12.0","description":"Lightweight core CLI surface for Claude Flow — memory + hooks commands only. Designed to load fast on cold npx cache (<5s) so plugin skills don't race the 30s MCP-startup timeout. The full @claude-flow/cli metapackage lazy-loads everything else on top of ","directories":{},"_nodeVersion":"22.22.1","publishConfig":{"tag":"alpha","access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli-core_3.7.0-alpha.5_1779262043507_0.7838885118684744","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-05-20T07:27:23.354Z","modified":"2026-09-13T15:30:28.014Z","3.7.0-alpha.5":"2026-05-20T07:27:23.666Z"},"bugs":{"url":"https://github.com/ruvnet/ruflo/issues"},"author":{"url":"https://github.com/ruvnet","name":"ruvnet"},"license":"MIT","homepage":"https://github.com/ruvnet/ruflo","keywords":["claude-flow","cli","core","lite","lazy-load","mcp","memory","hooks"],"repository":{"url":"git+https://github.com/ruvnet/ruflo.git","type":"git","directory":"v3/@claude-flow/cli-core"},"description":"Lightweight core CLI surface for Claude Flow — memory + hooks commands only. Designed to load fast on cold npx cache (<5s) so plugin skills don't race the 30s MCP-startup timeout. The full @claude-flow/cli metapackage lazy-loads everything else on top of ","maintainers":[{"email":"engineering@aigentic.net","name":"aiggy"}],"readme":"# @claude-flow/cli-core\n\n[![npm version](https://img.shields.io/npm/v/@claude-flow/cli-core.svg)](https://www.npmjs.com/package/@claude-flow/cli-core)\n[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/cli-core.svg)](https://www.npmjs.com/package/@claude-flow/cli-core)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> **Status:** alpha (pre-release). Tracking ADR-100. Don't depend on this in production yet.\n\nLightweight core CLI surface for [Claude Flow](https://github.com/ruvnet/ruflo) — `memory` + `hooks` commands only. Designed to load fast on a cold npx cache so plugin skills don't race Claude Code's 30 second MCP-startup timeout.\n\n## Why a separate package?\n\nIssue [#1748 #3](https://github.com/ruvnet/ruflo/issues/1748) documented a silent failure mode for new users: `npx claude-flow@latest mcp start` from a cold npx cache regularly exceeds 30 seconds (1.8 MB / 999 files), Claude Code's MCP startup timeout fires, zero tools register, and the user observes \"Ruflo is broken — no MCP tools available.\"\n\n`@claude-flow/cli-core` is a ≤250 KB packed subset containing only what plugin skills actually call: `memory store/list/retrieve/search/delete/init` and the `hooks` family (route, model-outcome, post-edit, pre-task, etc.). On a cold cache, `npx @claude-flow/cli-core@alpha memory store ...` should complete in under 5 seconds — well under the timeout.\n\n## Install\n\n```bash\n# Pre-release alpha\nnpm install @claude-flow/cli-core@alpha\n\n# Or just npx-invoke directly from a plugin Bash block\nnpx @claude-flow/cli-core@alpha memory store --key x --value 1 --namespace patterns\n```\n\n## What's included\n\n| Category | Commands |\n|---|---|\n| `memory` | `store`, `list`, `retrieve`, `search`, `delete`, `init`, `migrate`, `stats`, `configure`, `cleanup`, `compress`, `export`, `import` |\n| `hooks` | `route`, `pre-task`, `post-task`, `pre-edit`, `post-edit`, `pre-command`, `post-command`, `model-outcome`, `model-route`, `model-stats`, `worker-*`, `intelligence_*`, plus 12 background-worker dispatchers |\n\n## What's NOT included (use `@claude-flow/cli` for these)\n\n- `swarm`, `hive-mind`, `agent`, `task`, `coordination` — multi-agent orchestration\n- `neural`, `embeddings`, `intelligence` — full ML surface\n- `federation`, `claims`, `aidefence` — cross-installation features\n- `browser`, `wasm`, `rvf` — sandbox + browser automation\n- `init`, `migrate`, `doctor`, `daemon`, `deployment` — lifecycle management\n- `performance`, `security`, `providers`, `plugins`, `config` — admin surface\n\nFor any of these, install `@claude-flow/cli@alpha` (the metapackage that re-exports cli-core and lazy-loads everything else).\n\n## Compatibility\n\n`@claude-flow/cli-core@3.7.0-alpha.x` ships in lockstep with `@claude-flow/cli@3.7.0-alpha.x`. Once promoted from alpha → latest, the two packages will continue to share the major.minor line.\n\n## Verification\n\n```bash\n# Cold cache test — clear npx cache first\nrm -rf ~/.npm/_npx\ntime npx @claude-flow/cli-core@alpha memory store --key smoke --value test --namespace test\n# Expected: <5 seconds wall-time on typical broadband\n```\n\n## Documentation\n\n- [ADR-100 — cli-core split](../../docs/adr/ADR-100-cli-core-split-lazy-load.md) — design rationale\n- **[MIGRATION.md](./MIGRATION.md) — concrete diff + env-flag pattern for switching plugin scripts**\n- [Issue #1748](https://github.com/ruvnet/ruflo/issues/1748) — the bug this package addresses\n- [Issue #1760](https://github.com/ruvnet/ruflo/issues/1760) — alpha tracking issue (status, benchmarks, fire-by-fire progress)\n- [Main `@claude-flow/cli` README](../cli/README.md) — full feature list\n\n## License\n\nMIT\n","readmeFilename":"README.md"}