By Harvey Team
Platforms: macOS, Linux, and Windows. Windows support improved thanks to community contributions from @jesus-mgtc and @evgyur.
Run agents locally, in worktrees, in background — without touching main branch.
- Git Worktree Isolation - Each chat session runs in its own isolated worktree
- Background Execution - Run agents in background while you continue working
- Local-first - All code stays on your machine, no cloud sync required
- Branch Safety - Never accidentally commit to main branch
Cursor-like UI for Claude Code with diff previews, built-in git client, and the ability to see changes before they land.
- Diff Previews - See exactly what changes Claude is making in real-time
- Built-in Git Client - Stage, commit, and manage branches without leaving the app
- Change Tracking - Visual diffs and PR management
- Real-time Tool Execution - See bash commands, file edits, and web searches as they happen
Claude asks clarifying questions, builds structured plans, and shows clean markdown preview — all before execution.
- Clarifying Questions - Claude asks what it needs to know before starting
- Structured Plans - See step-by-step breakdown of what will happen
- Clean Markdown Preview - Review plans in readable format
- Review Before Execution - Approve or modify the plan before Claude acts
- Plan & Agent Modes - Read-only analysis or full code execution permissions
- Project Management - Link local folders with automatic Git remote detection
- Integrated Terminal - Full terminal access within the app
# Prerequisites: Bun, Python, Xcode Command Line Tools (macOS)
bun install
bun run claude:download # Download Claude binary (required!)
bun run build
bun run package:mac # or package:win, package:linuxImportant: The
claude:downloadstep downloads the Claude CLI binary which is required for the agent chat to work. If you skip this step, the app will build but agent functionality won't work.
Get pre-built releases + background agents support by subscribing at harvey.dev.
Your subscription helps us maintain and improve Harvey.
bun install
bun run claude:download # First time only
bun run dev前提：Harvey-DevKit 已在 http://localhost:3000 启动并完成 saas:migrate:v1、saas:seed:v1。
- 启动 Harvey API（8787）：
ANTHROPIC_AUTH_TOKEN=<your_provider_api_key> \
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic \
API_TIMEOUT_MS=3000000 \
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
HARVEY_CREDIT_CHECK=true \
HARVEY_DEVKIT_BASE_URL=http://localhost:3000 \
HARVEY_INTERNAL_API_KEY=dev-internal-key \
bun run harvey:api:core:dev- 健康检查：
curl --noproxy '*' http://localhost:8787/health
curl --noproxy '*' http://localhost:3000/api/health- OpenAI 兼容接口联调：
curl --noproxy '*' http://localhost:8787/v1/chat/completions \
-H 'content-type: application/json' \
-H 'x-api-key: dev-internal-key' \
-H 'x-user-id: dev-user-001' \
-H 'x-organization-id: dev-org-001' \
-d '{"model":"glm-4.5","stream":false,"messages":[{"role":"user","content":"reply exactly: OK"}],"metadata":{"chat_id":"demo-chat","sub_chat_id":"demo-sub","mode":"agent"}}'- 查看积分是否扣减（在 DevKit）：
curl --noproxy '*' -X POST http://localhost:3000/api/user/get-user-credits \
-H 'x-harvey-internal-key: dev-internal-key' \
-H 'x-harvey-user-id: dev-user-001' \
-H 'x-organization-id: dev-org-001'注意：
- 本地联调请使用
--noproxy '*'，避免系统代理导致localhost返回502。 - 租户字段推荐
x-organization-id；x-tenant-id仅兼容保留。
Harvey-DevKitWeb:http://localhost:3000Harvey桌面主应用:bun run dev启动 Electron
/web/full/ 测试页面已移除，避免误用。
Run the SaaS baseline + tenant-isolation smoke checks:
bun run saas:smoke:m0m1Optional mutation checks (consume credits):
SAAS_RUN_MUTATION=true bun run saas:smoke:m0m1Setup details and acceptance checklist:
docs/SAAS_TESTING.mddocs/ACCEPTANCE.md
Join our Discord for support and discussions.
Apache License 2.0 - see LICENSE for details.
This project includes third-party open source software; see THIRD_PARTY_NOTICES.md where applicable.