Welcome to the PackageFlow documentation! This guide will help you get the most out of PackageFlow.
- Getting Started - Install, import a project, run your first script
- MCP Server - Let AI tools control PackageFlow safely
- Time Machine - Dependency snapshots, integrity, security insights
- Security & Privacy - Local-first storage, encryption, permissions
- Troubleshooting - Common issues and fixes
- Feature Guides - Deep dives for each feature area
Stop juggling terminal tabs. Start clicking.
PackageFlow is a visual DevOps hub for Node.js projects — one app to run scripts, manage Git, and deploy. The killer feature? Your AI assistant can control it via MCP.
Built for the modern frontend workflow:
- React, Vue, Next.js, Nuxt — Run dev servers, build, and deploy with one click
- npm, pnpm, yarn, bun — Automatic package manager detection
- Monorepos — Nx, Turborepo, Lerna native support
- AI-assisted development — Generate commits, review code, analyze security
Local-first by design:
- Project metadata and automation live on your machine
- Secrets (tokens / API keys) are encrypted at rest (AES-256-GCM)
- MCP access is permissioned (read-only → confirm → full access)
- Frontend developers tired of juggling terminal windows
- Vibe coders who want to stay in flow, not memorize CLI commands
- Teams who want consistent workflows across projects
- AI-first developers using Claude Code, Codex, or Gemini CLI
| Before | After |
|---|---|
cd project-a && npm run dev × 5 tabs |
Click once. Done. |
| Manual deploy, copy preview URL | One-click deploy → instant link |
| "What was that command again?" | Visual workflows, zero memorization |
| AI can only read your code | AI runs your scripts, deploys, switches branches |
Use the docs below based on what you’re trying to do:
| Feature | Description | Documentation |
|---|---|---|
| Project Management | Import, scan, and manage your projects | Read more |
| One-Click Scripts | Run npm/pnpm/yarn scripts with live output | Read more |
| Visual Workflow | Build automation flows with drag-and-drop | Read more |
| Monorepo Support | Nx, Turborepo, Lerna integration | Read more |
| Feature | Description | Documentation |
|---|---|---|
| Git Integration | Visual Git operations without CLI | Read more |
| Worktree Management | Manage Git worktrees with quick switcher | Read more |
| Feature | Description | Documentation |
|---|---|---|
| One-Click Deploy | Deploy to Netlify, Cloudflare, GitHub Pages | Read more |
| Security Audit | Visual npm audit with vulnerability details | Read more |
| Time Machine | Dependency snapshots, diffs, integrity & security insights | Read more |
| Feature | Description | Documentation |
|---|---|---|
| AI Integration | Multi-provider AI (OpenAI, Anthropic, Gemini, Ollama) | Read more |
| MCP Server | Let Claude Code, Codex, Gemini CLI control PackageFlow | Read more |
| Webhooks | Incoming/outgoing webhook automation | Read more |
| Feature | Description | Documentation |
|---|---|---|
| Toolchain Management | Volta, Corepack, Node version detection | Read more |
| Keyboard Shortcuts | Customizable shortcuts reference | Read more |
React, Vue, Angular, Svelte, Solid, Next.js, Nuxt, Remix, Astro, Vite
npm, pnpm, yarn, bun (auto-detected from lockfiles)
Nx, Turborepo, Lerna, pnpm workspaces, yarn workspaces
Netlify, Cloudflare Pages, GitHub Pages, Vercel (coming soon)
OpenAI, Anthropic, Google, Ollama, LM Studio
- Platform: macOS (Windows and Linux coming soon)
- Node.js: 18+ (for project detection)
- GitHub Issues - Bug reports and feature requests
- Releases - Download latest version