@nikheal/devstate-cli
v1.1.1
Published
DevState CLI — capture, preserve, and restore AI coding session context. Never re-explain your project to a new AI chat again.
Maintainers
Readme
@nikheal/devstate-cli
DevState CLI — capture, preserve, and restore AI coding session context. Never re-explain your project to a new AI chat again.
DevState is a local-first, provider-neutral context engine that records architectural decisions, working sessions, and checkpoints, then surfaces them to any AI assistant (Claude, Cursor, Windsurf, and more) — automatically.
Install
npm install -g @nikheal/devstate-cliOr run without installing:
npx @nikheal/devstate-cli --helpKey Commands
| Command | What it does |
|---|---|
| devstate init | Analyze your project, create a workspace, and generate AGENTS.md / CLAUDE.md |
| devstate session start "<intent>" | Start a working session with a stated intent |
| devstate checkpoint [notes] | Snapshot your current git diff and untracked files |
| devstate restore [id] | Restore a saved checkpoint |
| devstate decision add "<text>" --why "<reason>" | Record an architectural decision and its rationale |
| devstate status | Show workspace status, active session, and git changes |
| devstate doctor | Diagnostic check — infrastructure, freshness, context completeness |
# Example workflow
devstate init
devstate session start "Refactor payment module"
devstate checkpoint "Cart logic extracted to service"
devstate decision add "Use Stripe webhooks" --why "reliable delivery over polling"
devstate status
devstate session closeFull Documentation
See the main README for:
- Complete CLI reference (all commands and flags)
- MCP server integration (Claude Desktop, Cursor, Windsurf)
- How decisions, sessions, and context generation work
- Team workflows and fresh clone behavior
License
MIT © 2025 Nikhil Patel
