{"_id":"@aavn/epost-kit","_rev":"2-2cf60ffe5a765449d829256a1f431151","name":"@aavn/epost-kit","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@aavn/epost-kit","version":"0.0.1","keywords":["cli","agent-kit","claude-code","github-copilot","cursor","developer-tools","ai-agents","code-generation"],"author":{"name":"Phuong Doan"},"license":"MIT","_id":"@aavn/epost-kit@0.0.1","maintainers":[{"name":"phuongdoan-aavn","email":"phuong.doanduy@axonactive.com"}],"homepage":"https://github.com/Klara-copilot/epost-agent-kit-cli#readme","bugs":{"url":"https://github.com/Klara-copilot/epost-agent-kit-cli/issues"},"bin":{"epost-kit":"dist/cli.js"},"dist":{"shasum":"f31a335f7adee31afbb783dca46a85ea7dff3c28","tarball":"https://registry.npmjs.org/@aavn/epost-kit/-/epost-kit-0.0.1.tgz","fileCount":482,"integrity":"sha512-RseOxOIkOmasGHwV0mZ7EiZAXmobwkOuPkLjW8mjJWx4wZWPyBz5GOaIqh511Ch6wNdw+T5T2soacPq71oLTwA==","signatures":[{"sig":"MEYCIQDsviC0taKD6/05bR/cqJpyUwEfV+dVUSyWdSNGYbb37wIhAJo9iPCrHNukR+Nf7BwBsBCmR7c+cQ0z3IEttOM0pTW4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1218981},"type":"module","engines":{"node":">=18.0.0"},"exports":{".":"./dist/index.js","./cli":"./dist/cli.js"},"gitHead":"a252d3f1cbc2e51f77b1d53eb37dd562e5b18897","scripts":{"dev":"tsc --watch","lint":"eslint src tests","test":"vitest run","build":"tsc && tsc-alias && node -e \"if(process.platform!=='win32')require('fs').chmodSync('dist/cli.js',0o755)\"","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run typecheck && npm run lint && npm run test && npm run build"},"_npmUser":{"name":"phuongdoan-aavn","email":"phuong.doanduy@axonactive.com"},"repository":{"url":"git+https://github.com/Klara-copilot/epost-agent-kit-cli.git","type":"git"},"_npmVersion":"11.11.1","description":"Distribution CLI for epost-agent-kit - multi-IDE agent framework","directories":{},"_nodeVersion":"25.8.2","dependencies":{"cac":"^6.7.14","ora":"^8.1.1","tar":"^7.5.7","zod":"^3.24.1","execa":"^9.5.2","minimatch":"^10.1.2","@types/tar":"^6.1.13","cli-table3":"^0.6.5","picocolors":"^1.1.1","cosmiconfig":"^9.0.0","@inquirer/prompts":"^7.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.18.0","vitest":"^2.1.8","globals":"^15.15.0","tsc-alias":"^1.8.16","typescript":"^5.7.3","@types/node":"^22.10.5","@vitest/coverage-v8":"^2.1.9","@typescript-eslint/parser":"^8.20.0","@typescript-eslint/eslint-plugin":"^8.20.0"},"_npmOperationalInternal":{"tmp":"tmp/epost-kit_0.0.1_1775193438664_0.9211135457051893","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@aavn/epost-kit","version":"0.0.2","description":"Distribution CLI for epost-agent-kit - multi-IDE agent framework","type":"module","bin":{"epost-kit":"dist/cli.js"},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsc && tsc-alias && node -e \"if(process.platform!=='win32')require('fs').chmodSync('dist/cli.js',0o755)\"","dev":"tsc --watch","test":"vitest run","test:watch":"vitest","lint":"eslint src tests","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run lint && npm run test && npm run build"},"exports":{".":"./dist/index.js","./cli":"./dist/cli.js"},"publishConfig":{"access":"public"},"keywords":["cli","agent-kit","claude-code","github-copilot","cursor","developer-tools","ai-agents","code-generation"],"author":{"name":"Phuong Doan"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Klara-copilot/epost-agent-kit-cli.git"},"dependencies":{"@inquirer/prompts":"^7.2.0","@types/tar":"^6.1.13","cac":"^6.7.14","cli-table3":"^0.6.5","cosmiconfig":"^9.0.0","execa":"^9.5.2","minimatch":"^10.1.2","ora":"^8.1.1","picocolors":"^1.1.1","tar":"^7.5.7","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.10.5","@typescript-eslint/eslint-plugin":"^8.20.0","@typescript-eslint/parser":"^8.20.0","@vitest/coverage-v8":"^2.1.9","eslint":"^9.18.0","globals":"^15.15.0","tsc-alias":"^1.8.16","typescript":"^5.7.3","vitest":"^2.1.8"},"_id":"@aavn/epost-kit@0.0.2","gitHead":"fceb615199deac1e702fcaa6427fb1903480467c","bugs":{"url":"https://github.com/Klara-copilot/epost-agent-kit-cli/issues"},"homepage":"https://github.com/Klara-copilot/epost-agent-kit-cli#readme","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-sCeEw78Oc7oAVmaY+79zSbUd03riRVGbEmjAOYpkN8Hio+F/Tm8ZQLKbgeMRCINy0RW1g3zX6LFUbvrhnc3tEQ==","shasum":"1a07485615b9c8cf4a31bc233872745b20ab1a86","tarball":"https://registry.npmjs.org/@aavn/epost-kit/-/epost-kit-0.0.2.tgz","fileCount":482,"unpackedSize":1221016,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aavn%2fepost-kit@0.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCsvG/fVDv+qEFInfKUwpIkaryzn0nkNrs6wKfWkF5LxgIhAKFbhss7OKXtpw9acD3qPiMRoP1NAUggfOjNDlR4E8Om"}]},"_npmUser":{"name":"phuongdoan-aavn","email":"phuong.doanduy@axonactive.com"},"directories":{},"maintainers":[{"name":"phuongdoan-aavn","email":"phuong.doanduy@axonactive.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/epost-kit_0.0.2_1775449031043_0.8363523011664475"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-03T05:17:18.577Z","modified":"2026-04-06T04:17:11.547Z","0.0.1":"2026-04-03T05:17:18.845Z","0.0.2":"2026-04-06T04:17:11.244Z"},"bugs":{"url":"https://github.com/Klara-copilot/epost-agent-kit-cli/issues"},"author":{"name":"Phuong Doan"},"license":"MIT","homepage":"https://github.com/Klara-copilot/epost-agent-kit-cli#readme","keywords":["cli","agent-kit","claude-code","github-copilot","cursor","developer-tools","ai-agents","code-generation"],"repository":{"type":"git","url":"git+https://github.com/Klara-copilot/epost-agent-kit-cli.git"},"description":"Distribution CLI for epost-agent-kit - multi-IDE agent framework","maintainers":[{"name":"phuongdoan-aavn","email":"phuong.doanduy@axonactive.com"}],"readme":"# epost-kit CLI\n\nDistribution CLI for epost-agent-kit — installs and manages the multi-IDE AI agent framework across Claude Code, Cursor, and VS Code GitHub Copilot.\n\n**Version:** 0.0.1 | **Node:** >= 18.0.0 | **License:** MIT\n\n---\n\n## Installation\n\n**Prerequisites:** Node.js >= 18, git\n\nNote: GitHub CLI (gh) is required after install to use `epost-kit install`.\n\n### Recommended — npm (all platforms)\n\n```bash\nnpm install -g @aavn/epost-kit\n```\n\n### Alternative — install scripts\n\n**macOS / Linux / WSL:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Klara-copilot/epost-agent-kit-cli/master/install/install.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https://raw.githubusercontent.com/Klara-copilot/epost-agent-kit-cli/master/install/install.ps1 | iex\n```\n\n**Windows (Command Prompt, fallback):**\n```cmd\ncurl -fsSL https://raw.githubusercontent.com/Klara-copilot/epost-agent-kit-cli/master/install/install.cmd -o \"%TEMP%\\epost-kit-install.cmd\" && \"%TEMP%\\epost-kit-install.cmd\" && del \"%TEMP%\\epost-kit-install.cmd\"\n```\n\nFor manual installation and troubleshooting, see [install/README.md](./install/README.md).\n\n---\n\n## Quick Start\n\n```bash\n# Install full kit (interactive wizard)\nepost-kit install\n\n# Install non-interactively\nepost-kit install --full                  # all features\nepost-kit install --bundle web-frontend   # web role\nepost-kit install --skill discover        # single skill\n\n# Check status\nepost-kit status\nepost-kit doctor\n\n# Diagnose routing\nepost-kit trace \"build a login page\"\n```\n\n---\n\n## Commands\n\n### Install\n\n#### `epost-kit install` / `epost-kit init`\nInteractive setup wizard — or non-interactive with flags.\n\n```bash\nepost-kit install                              # interactive (7-step wizard)\nepost-kit install --full                       # full kit, no prompts\nepost-kit install --bundle web-frontend        # install a role bundle\nepost-kit install --bundle ios-developer\nepost-kit install --bundle android-developer\nepost-kit install --bundle backend-api\nepost-kit install --bundle designer\nepost-kit install --bundle kit-author\nepost-kit install --skill discover             # single skill\nepost-kit install --preview                    # show what will be created\nepost-kit install --target cursor              # target Cursor IDE\nepost-kit install --target vscode              # target VS Code Copilot\nepost-kit install --fresh                      # wipe + reinstall\nepost-kit install --source /path/to/kit        # use local source (dev)\n```\n\n**Targets:**\n| Flag | Installs to | Format |\n|------|-------------|--------|\n| `--target claude` *(default)* | `.claude/` | Claude Code agents |\n| `--target cursor` | `.cursor/` + `.cursor/rules/` | Cursor agents + `.mdc` rules |\n| `--target vscode` | `.github/` | Copilot `.agent.md` + `hooks.json` |\n\n---\n\n### Inspect\n\n#### `epost-kit status`\nShow current install — scope, enabled items, mode.\n\n```bash\nepost-kit status          # human-readable summary\nepost-kit status --json   # machine-readable\n```\n\n#### `epost-kit list`\nList installed items.\n\n```bash\nepost-kit list skills\nepost-kit list agents\nepost-kit list hooks\n```\n\n#### `epost-kit show`\nDisplay configuration and routing.\n\n```bash\nepost-kit show routing    # render routing table from CLAUDE.md\nepost-kit show config     # display .epost.json config\n```\n\n---\n\n### Diagnose\n\n#### `epost-kit doctor`\nPreflight checks — git, node, tools, env, permissions.\n\n```bash\nepost-kit doctor              # run all checks\nepost-kit doctor --dir <path> # check a specific project directory\nepost-kit doctor --fix        # auto-fix issues\nepost-kit doctor --report     # detailed JSON report\n```\n\n#### `epost-kit validate`\nPost-install structured validation (config, skills, routing, delegation, hooks).\n\n```bash\nepost-kit validate          # structured pass/warn/fail per check\nepost-kit validate --json   # machine-readable\n```\n\n#### `epost-kit dry-run \"<prompt>\"`\nSimulate routing for a natural language prompt without running anything.\n\n```bash\nepost-kit dry-run \"build a login page\"\nepost-kit dry-run \"commit and push\" --json\n```\n\n#### `epost-kit trace \"<prompt>\"`\nVerbose orchestration trace — shows intent classification, rule match, agent dispatch.\n\n```bash\nepost-kit trace \"build a login page\"\nepost-kit trace \"commit and push\" --json\n```\n\n#### `epost-kit repair`\nAuto-fix validation failures by re-running the install engine.\n\n```bash\nepost-kit repair          # check + prompt to fix\nepost-kit repair --yes    # fix without confirmation\nepost-kit repair --json   # machine-readable result\n```\n\n---\n\n### Manage\n\n#### `epost-kit enable` / `epost-kit disable`\nToggle individual skills or hooks without reinstalling.\n\n```bash\nepost-kit enable skill review\nepost-kit disable skill discover\nepost-kit enable hook knowledge-capture\nepost-kit disable hook auto-capture\n```\n\n#### `epost-kit add` / `epost-kit remove`\nAdd or remove individual skills/bundles from an existing install.\n\n```bash\nepost-kit add skill review\nepost-kit remove bundle mobile\nepost-kit add skill review --preview    # dry-run\nepost-kit add skill review --json\n```\n\n#### `epost-kit update`\nRe-install from existing metadata (profile + target preserved).\n\n```bash\nepost-kit update                                    # reinstall current setup\nepost-kit update --preview                          # show what would change\nepost-kit update --source /path/to/epost_agent_kit  # use local source\nepost-kit update --json\n```\n\n#### `epost-kit upgrade`\nCheck for and apply CLI and kit content updates.\n\n```bash\nepost-kit upgrade           # check both CLI and kit content\nepost-kit upgrade --check   # report only, no install\nepost-kit upgrade --json    # machine-readable version status\n```\n\n#### `epost-kit uninstall`\nRemove the installed kit, respecting file ownership.\n\n```bash\nepost-kit uninstall                  # interactive\nepost-kit uninstall --keep-custom    # keep user-modified files\nepost-kit uninstall --force          # remove everything\nepost-kit uninstall --dry-run        # preview what would be removed\nepost-kit uninstall --json\n```\n\n---\n\n### Other\n\n#### `epost-kit config`\nView and edit kit configuration.\n\n```bash\nepost-kit config show                     # print current config\nepost-kit config get plan.engine          # get a value\nepost-kit config set plan.engine gemini   # set a value\nepost-kit config reset                    # restore defaults\nepost-kit config ignore add <glob>        # add ignore pattern\nepost-kit config ignore remove <glob>     # remove ignore pattern\n```\n\n#### `epost-kit dev`\nLive-sync a local kit source (for kit authors).\n\n```bash\nepost-kit dev init    # install from ../epost_agent_kit + start watcher\nepost-kit dev update  # one-shot update from local source\nepost-kit dev stop    # stop background watcher\n```\n\n#### `epost-kit convert`\nConvert Claude Code agent config to VS Code Copilot format.\n\n```bash\nepost-kit convert                    # convert installed .claude/ → .github/\nepost-kit convert --dry-run          # preview\nepost-kit convert --profile web-fullstack\n```\n\n#### `epost-kit profile`\nBrowse available developer profiles.\n\n```bash\nepost-kit profile list                  # list all profiles\nepost-kit profile show web-fullstack    # show profile details\n```\n\n#### `epost-kit lint` / `fix-refs` / `verify`\nQuality checks for kit package authors.\n\n```bash\nepost-kit lint                # validate references\nepost-kit fix-refs --apply    # fix stale references\nepost-kit verify --json       # full audit, machine-readable\n```\n\n---\n\n## Global Options\n\n```\n--verbose    Enable debug logging\n--yes        Skip all prompts (CI mode)\n--help       Show command help\n--version    Show CLI version\n```\n\n---\n\n## Configuration\n\nKit config is stored in `<installDir>/.epost-kit.json`. Edit via `epost-kit config` or directly:\n\n```json\n{\n  \"target\": \"claude\",\n  \"profile\": \"web-fullstack\",\n  \"plan\": {\n    \"engine\": \"gemini\",\n    \"dateFormat\": \"YYMMDD-HHmm\"\n  }\n}\n```\n\n**Environment variables:**\n| Variable | Purpose |\n|----------|---------|\n| `EPOST_KIT_TARGET` | Override IDE target |\n| `EPOST_KIT_PROFILE` | Override profile |\n| `EPOST_KIT_REGISTRY` | Override package registry URL |\n| `EPOST_RESEARCH_ENGINE` | Override research engine (`websearch` \\| `gemini` \\| `perplexity`) |\n\n**API keys** (stored in `<installDir>/.env`, never committed):\n- `GEMINI_API_KEY` — for Gemini research engine\n\n---\n\n## Multi-IDE Support\n\n| Feature | Claude Code | Cursor | VS Code Copilot |\n|---------|:-----------:|:------:|:---------------:|\n| Agents | ✓ `.md` | ✓ `.md` (5 fields) | ✓ `.agent.md` |\n| Skills | ✓ | ✓ | ✓ |\n| Hooks | ✓ (all events) | ✓ (settings.json) | ✓ (SessionStart, Stop) |\n| Rules/Context | CLAUDE.md | CLAUDE.md + `.cursor/rules/*.mdc` | `copilot-instructions.md` |\n| Agent handoffs | ✓ | ✗ | ✓ |\n| Compatibility report | — | ✓ (warns on dropped fields) | ✓ (warns on dropped fields) |\n\n---\n\n## Development\n\nLocal development setup for contributors working from a checkout of this CLI:\n\n```bash\ngit clone <repo>\ncd epost-agent-kit-cli\nnpm install && npm run build && npm link\n\nnpm test           # run tests\nnpm run dev        # watch mode\nnpm run typecheck  # type check only\n```\n\n**Use local kit source during development:**\n```bash\nepost-kit init --source /path/to/epost_agent_kit\n# or\nepost-kit dev init\n```\n\n---\n\n## Troubleshooting\n\n**\"GitHub authentication required\"**\n```bash\ngh auth login && gh auth token\n```\n\n**Update fails with combined profile name**\nCombined profiles (`web-fullstack+web-ui-lib`) are supported — `update` expands them automatically.\n\n**VS Code hooks not firing**\nVS Code only supports `SessionStart` and `Stop` hook events. Other events (UserPromptSubmit, PreToolUse, etc.) are Claude Code extensions and silently fail in VS Code — this is expected.\n\n**Debug mode**\n```bash\nepost-kit --verbose <command>\n```\n\n---\n\n## Architecture\n\n```\nsrc/\n├── cli.ts                    # entry point, command registration\n├── commands/                 # thin orchestrators (init, update, config, dev…)\n├── domains/\n│   ├── config/               # config loading, merging, ignore patterns\n│   ├── installation/         # target adapters (Claude, Cursor, VS Code)\n│   ├── packages/             # package resolver, profile loader, YAML parser\n│   ├── health-checks/        # doctor checks\n│   └── validation/           # lint, fix-refs\n├── services/                 # file operations, template engine\n├── shared/                   # logger, file-system utils, constants\n└── types/                    # TypeScript interfaces\n```\n\n**Key design decisions:**\n- Adapter pattern for multi-IDE output (ClaudeAdapter / CursorAdapter / CopilotAdapter)\n- Custom YAML parser — no `js-yaml` dependency\n- File ownership tracking via SHA256 checksums (`.epost-metadata.json`)\n- Topological sort (Kahn's algorithm) for package dependency ordering\n\n---\n\n*Last updated 2026-04-01*\n","readmeFilename":"README.md"}