Documentation

Five minutes
to your first finish.

Quickstart

  1. Install & launch. Get the signed Windows installer from the download page. Wanju opens in its own desktop window with no local web port.
  2. Choose your projects. GitHub is recommended (a one-time device code) because it also lists your repositories. A local profile needs no account.
  3. Import your unfinished projects. Select any number of GitHub repos — they clone in the background with progress bars. Or point the workspace at an existing local folder.
  4. Read the dashboard. Each card shows the project's stage, staleness, and next step. Insight chips point to the cheapest wins.
  5. Dispatch an agent when you are ready. Wanju explains AI setup at that point. The built-in agent uses your own OpenAI, Anthropic, or Gemini key.
  6. Review & push. Agent proposals appear in AI Changes before they are applied. Review, test, commit, and push from there.

The workflow, daily

Open the dashboard. It answers three questions in one glance: what state is everything in, is anything waiting on me (the approvals inbox), and what happened (the activity feed). Pick the project the insights point at, dispatch the next step, and approve the result when it's ready. The loop is: see state → dispatch → approve → auto-verify → state updates.

Task format

---
id: "PM-123456"
title: "Add authentication"
status: "in_progress"
priority: "high"
acceptance:
  - "Authentication tests pass"
---

## Progress
- [x] Define API
- [ ] Build login UI

Plain Markdown in .project-manager/tasks/ — humans, the app, and agents share the same files.

Crossed the finish line?

When a project ships, put the flag on it. Add the badge finished with Wanju to its README:

[![finished with Wanju](https://wanju.dev/badge.svg)](https://wanju.dev)

Frequently asked

Normal project work stays on your machine. AI features send only relevant project context to the AI provider you configured, using your own key and your own account with that provider — never through Wanju. Credential-like files are excluded in every direction. The one opt-in exception is cellular approvals, which pass encrypted approval payloads through Wanju's temporary relay; the relay never receives the decryption key and the session is deleted when it ends or expires.