@premierstudio/plannable
v1.1.8
Published
CLI for connecting AI coding tools to Plannable's MCP server
Readme
@premierstudio/plannable
Connect your AI coding tools to Plannable with a single command. Automatically detects your IDE, sets up MCP connections, and installs PM-AI hooks that keep your AI tools in sync with Plannable.
Quick Start
npx @premierstudio/plannableThat's it. The CLI will:
- Authenticate via OAuth (opens browser)
- Detect your AI tools (Claude Code, Cursor, Gemini CLI, Codex, and more)
- Configure MCP server connections for each detected tool
- Install PM-AI hooks for intelligent guardrails
Commands
npx @premierstudio/plannable # Interactive setup (default)
npx @premierstudio/plannable status # Check connection status
npx @premierstudio/plannable remove # Clean removalOptions
--server <url> Plannable server URL (default: https://plannable.ai)
Also configurable via PLANNABLE_SERVER env varSupported AI Tools
| Tool | Detection | MCP | Hooks |
| ----------- | ------------------------------------------------- | --- | ------- |
| Claude Code | claude CLI or .claude/ directory | Yes | Yes |
| Cursor | cursor CLI or .cursor/ directory | Yes | Yes |
| Gemini CLI | gemini CLI or .gemini/ directory | Yes | Yes |
| Codex | codex CLI, codex.json, or .codex/ directory | Yes | Yes |
| Cline | cline CLI or .clinerules/ directory | Yes | Yes |
| Kiro | kiro CLI or .kiro/ directory | Yes | Yes |
| OpenCode | opencode CLI or .opencode/ directory | Yes | Yes |
| Droid | droid CLI or .factory/ directory | Yes | Yes |
| Amp | amp CLI or .amp/ directory | Yes | Planned |
What Are PM-AI Hooks?
Hooks are lightweight middleware that run inside your AI tool. They let Plannable:
- Guide your AI toward the right tasks and priorities
- Enforce project conventions automatically
- Signal file and shell activity back to Plannable for risk detection
- Block unsafe operations before they happen
Hooks are installed via ai-hooks, a universal hooks framework for AI coding tools.
Self-Hosted
# Use a custom server
npx @premierstudio/plannable --server https://your-instance.example.com
# Or set via environment variable
PLANNABLE_SERVER=https://your-instance.example.com npx @premierstudio/plannableRequirements
- Node.js >= 22.0.0
- At least one supported AI coding tool installed
License
MIT
