ANDA PM

ANDA PM is a small local PM dashboard for AI coding workflows. It helps vibe coders track local project status, Git state, stage plans, risks, and next actions across multiple projects.

ANDA PM is not a SaaS product. It runs on your computer and reads project folders stored locally.

한국어 README

Who is this for?

• Developers using Claude Code, Codex, Cursor, Antigravity, GitHub, and terminal-based AI coding workflows
• Vibe coders managing multiple local projects who want a simple project status board

Quick Start for Developers

Replace <ANDA-PM-GITHUB-URL> with the URL of this repository.

git clone <ANDA-PM-GITHUB-URL>
cd anda-pm
npm install
npm run serve

The terminal prints the local address to open in your browser. It may look like:

http://127.0.0.1:4173

This address is only an example. Always open the address shown after npm run serve.

Connect a Project

Cloning ANDA PM installs only ANDA PM itself. Your existing projects are not connected automatically.

1. Open the local dashboard address shown in the terminal.
2. Choose a project from Projects found on this computer.
3. Click Connect this project.
4. If the project is not listed, use Find project folder directly.
5. Confirm that the project card appears on the dashboard.

PM Documents and Stage Plans

Connecting a project does not automatically create its project plan. ANDA PM reads PM documents already stored in the connected local project folder.

• BLUEPRINT.md: recommended file for numbered stage plans and stage status
• CURRENT_STATUS.md: current progress, completed work, next actions, and risks
• TODO.md: remaining tasks

Without these documents, the dashboard may not show stage plans or detailed PM status. Non-developers can ask an AI assistant to create the documents, save them in the project folder, and then use Reload PM documents in ANDA PM.

Recommended stage statuses are done, active, todo, and blocked.

Safety

Disconnecting a project only removes it from ANDA PM's connection list. It never deletes the actual project folder.

Local Projects vs. GitHub

ANDA PM reads local project folders, not GitHub repositories directly.

• Reload PM documents reads files from the connected local project path.
• It does not run git pull or automatically fetch updates from GitHub.
• To reflect GitHub changes, update the project in its own local folder first, then reload its PM documents in ANDA PM.

Tests

npm test