Package Exports
- @aadhib/founderos
- @aadhib/founderos/bootstrap
- @aadhib/founderos/package.json
- @aadhib/founderos/setup-wizard
Readme
founderos CLI
The TypeScript CLI that powers Founder OS. Detects your AI tools, places skills in the right directories, and keeps everything in sync.
Install
npx @aadhib/founderos installCommands
| Command | Description |
|---|---|
founderos install |
Interactive setup wizard (or --yes for non-interactive) |
founderos doctor |
Environment + manifest health check |
founderos list |
List all skills and install status (--json supported) |
founderos update |
Re-sync installed skills with the latest catalog |
founderos init |
Scaffold Founder OS into the current project |
founderos add <skill> |
Install a single skill |
founderos remove <skill> |
Remove a single skill |
founderos verify |
Validate the skill catalog (used in CI) |
founderos examples [skill] |
Browse the bundled example library |
founderos integrations |
Show supported tools and detection status |
Architecture
src/
├── index.ts Commander wiring + top-level error handling
├── commands/ one file per command
├── installers/ skill placement logic
├── integrations/ per-tool detection (Claude Code, Cursor, Codex, Gemini)
├── templates/ scaffolding strings for `init`
└── utils/ logger, env, fs, paths, skills, manifestState lives at ~/.founderos/manifest.json — the record of what was installed
where, so update and remove are precise rather than best-effort.
Develop
pnpm install
pnpm --filter @aadhib/founderos build
pnpm --filter @aadhib/founderos test
node cli/dist/index.js doctor