PackageFlow

The AI-Driven package.json Project Manager
_{Turn scripts, Git, workflows, deploys, and MCP tools into one-click actions.}

📥 Download • ✨ Features • 🤖 AI & MCP • 📚 Docs • 📸 Screenshots • ❓ FAQ

---

---

Why PackageFlow?

"Claude, deploy my feature branch." "Run tests and fix any failures." "Switch to the main branch and start the dev server."

PackageFlow is an AI-driven package.json project management tool — a single control center for how you build, ship, and automate.

Before PackageFlow	With PackageFlow
Terminal juggling	One-click scripts
Manual deployments	Instant preview links
Command memorization	Visual workflows
AI can't touch your tools	MCP Server lets AI control everything

Powered by Tauri + Rust — lightweight, fast startup, local-first by design.

🎬 Quick Start

# Install via Homebrew
brew tap runkids/tap && brew install --cask packageflow

Or download directly → Drag a project folder → Start clicking.

💡 Press Cmd + K for instant worktree switching

Try It in 60 Seconds

1. Import a project (drag a folder with package.json)
2. Click a script card like dev / build / test
3. Create a workflow for your repetitive tasks (dev → test → deploy)
4. (Optional) Enable MCP so your AI tool can run actions for you

Common Use Cases

• One-click “dev / build / test” across many repos
• Worktree switching without losing context
• Repeatable release pipelines (test → build → deploy)
• Fast security audits with AI explanations
• “AI as teammate” via MCP tool calls (safe + permissioned)

---

✨ Features

🎯 One-Click Everything Run scripts, workflows, deploys — no commands to memorize. ⚡ Visual Workflow Builder Drag-and-drop automation with conditional steps. 🚀 Instant Deploy One click → live preview link on Netlify or Cloudflare. 📦 Monorepo-Native Nx, Turborepo, Lerna — auto-detected and ready.

🔀 Git Without CLI Commit, branch, stash, diff — all visual, all easy. 🌳 Worktree Superpowers See all worktrees, switch instantly, resume sessions. 🛡️ Security Scanner Visual npm audit with AI-powered analysis. 🔧 Toolchain Detective Auto-detect Volta, Corepack, nvm conflicts.

---

🤖 AI & MCP Integration

AI generates commit messages from your diffs

Multi-Provider AI Support

Provider	Type	Use Case
OpenAI	Cloud	Complex analysis
Anthropic	Cloud	Claude for intelligent commits
Google	Cloud	Gemini for fast responses
Ollama	Local	Privacy-first, unlimited
LM Studio	Local	Custom models, no API costs

MCP Server — Let AI Control Your Dev Environment

PackageFlow exposes a Model Context Protocol (MCP) server that AI assistants can use:

"Claude, deploy my feature branch to staging."
"Run tests for all projects and report failures."
"Switch to the payment-fix worktree and start the dev server."

Works with:

• Claude Code
• Codex CLI
• Gemini CLI
• Any MCP-compatible AI tool

What AI Actually Does (MCP Tool Chains)

PackageFlow is “AI-driven” because the AI can call real tools (not just generate text). Example flows:

1) Understand a project

• You: “List my projects and show scripts for the frontend repo”
• Tools: list_projects → get_project

2) Run a script with context

• You: “Run tests for the packages/web project and summarize failures”
• Tools: get_project → run_npm_script

3) Generate a commit message from staged changes

• You: “Write a conventional commit message for what I staged”
• Tools: get_git_diff → (AI drafts message)

MCP Setup (Copy/Paste)

PackageFlow ships a companion MCP server binary: packageflow-mcp (stdio transport).

In PackageFlow, open Settings → MCP → MCP Integration and copy the generated config for:

• Claude Code / VS Code (JSON)
• Codex CLI (TOML)

Then your AI tool can call actions like list_projects, run_npm_script, run_workflow, and more.

AI CLI Integration

Run AI commands directly from PackageFlow:

You: "Analyze the security audit results and suggest fixes"
AI: Analyzing 3 high-severity vulnerabilities...

Security First:

• All API keys encrypted with AES-256-GCM
• Permission levels: Read Only → Confirm → Full Access
• Fine-grained tool permissions
• Complete request logging

Security & Privacy (Local-First)

PackageFlow is designed to keep your projects and secrets on your machine.

• Data stays local; AI features are opt-in
• Keys/tokens encrypted at rest
• MCP is permissioned (read → confirm → full)

Read more: Security & Privacy

---

📚 Documentation

Documentation home: English • 繁體中文 • 简体中文

📖 Full Feature Documentation

Feature	Description
Getting Started	Installation and first steps
Security & Privacy	Local-first storage and permissions
Troubleshooting	Common issues and fixes
Project Management	Import and manage projects
One-Click Scripts	Run npm scripts with live terminal
Visual Workflow	Drag-and-drop automation
Monorepo Support	Nx, Turbo, Lerna integration
Git Integration	Visual Git operations
Worktree Management	Quick worktree switching
One-Click Deploy	Deploy to Netlify/Cloudflare
Security Audit	Vulnerability scanning
Time Machine	Dependency snapshots & integrity
AI Integration	Multi-provider AI support
MCP Server	AI tool integration
Webhooks	Incoming/outgoing automation
Toolchain Management	Node.js version management
Keyboard Shortcuts	Complete shortcut reference

---

📸 Screenshots

🎯 Projects + Scripts

🌳 Worktrees

⚡ Visual Workflow Builder

📦 Monorepo Support

🔗 Dependency Graph

🔀 Git Integration

🛡️ Security Audit

🚀 Deploy Accounts

💻 Terminals

🔌 Webhooks

🧳 Worktree Sessions

⌨️ Keyboard Shortcuts

📦 Installation

Homebrew (Recommended)

brew tap runkids/tap
brew install --cask packageflow

Upgrade

brew update && brew upgrade --cask packageflow

Troubleshooting

If you see an error like It seems the App source '/Applications/PackageFlow.app' is not there:

# Force uninstall the old cask record
brew uninstall --cask --force packageflow

# Reinstall
brew install --cask runkids/tap/packageflow

Direct Download

Download the latest release → Open the .dmg → Drag to Applications.

---

🗺️ Roadmap

Recently Shipped

• Multi-Provider AI — OpenAI, Anthropic, Google, Ollama, LM Studio
• MCP Server — Let AI assistants control PackageFlow
• AI CLI Integration — Claude Code, Codex, Gemini CLI
• AI Security Analysis — Intelligent vulnerability explanations
• Notification Center — Background task monitoring
• System Theme — Auto light/dark mode

Coming Soon

• 🪟 Windows Support — Cross-platform expansion
• 🐧 Linux Support — Complete desktop coverage
• 📦 Plugin System — Community extensions
• 🔄 MCP Actions — Custom AI-triggered workflows
• 🌐 Remote Collaboration — Team workflow sharing

💡 Request a feature or vote on existing ones!

❓ FAQ

How is this different from VS Code terminal?

PackageFlow is about flow, not terminals:

• One-click actions for everything
• Visual workflow builder
• Built-in deploy with preview links
• AI assistants can control it via MCP
• No extension sprawl — everything integrated

Is my data safe?

100% local-first.

• All data stays on your machine
• API keys encrypted with AES-256-GCM
• No tracking, no telemetry
• AI features are opt-in
• MCP permissions are granular

What AI providers are supported?

Cloud: OpenAI, Anthropic (Claude), Google (Gemini) Local: Ollama, LM Studio — unlimited, private, free

Use local models for sensitive code. Use cloud for convenience.

What is MCP and why should I care?

Model Context Protocol (MCP) is how AI assistants talk to tools.

With PackageFlow's MCP server:

• Claude Code can deploy your projects
• AI can run scripts and workflows
• Voice-controlled development becomes possible

It's like giving AI hands to help you code.

🛠 Development

Prerequisites

• Node.js 18+
• Rust 1.70+
• pnpm

Setup

# Clone the repository
git clone https://github.com/runkids/PackageFlow.git
cd PackageFlow

# Install dependencies
pnpm install

# Start Vite (web UI)
pnpm dev

# Start the desktop app
pnpm dev:tauri

Build

# Build web assets
pnpm build

# Build the desktop app (dmg)
pnpm build:tauri

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Ways to Contribute

• 🐛 Report bugs and request features via Issues
• 🔧 Submit pull requests for bug fixes or new features
• 📝 Improve documentation
• 🔄 Share your workflow templates

Development Guidelines

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

🙏 Acknowledgments

Built with amazing open-source tools:

Tauri • React Flow • Lucide • Claude Code

---

---

If PackageFlow saves you time, give us a star!

_{MIT License • Made by runkids}