Home Original page

GitHub - crazyboyonline/Harveycode

Harvey

Harvey

By Harvey Team

Platforms: macOS, Linux, and Windows. Windows support improved thanks to community contributions from @jesus-mgtc and @evgyur.

Features

Run Claude agents the right way

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

UI that finally respects your code

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

Plan mode that actually helps you think

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

More Features

  • 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

Installation

Option 1: Build from source (free)

# 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:linux

Important: The claude:download step 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.

Option 2: Subscribe to Harvey (recommended)

Get pre-built releases + background agents support by subscribing at harvey.dev.

Your subscription helps us maintain and improve Harvey.

Development

bun install
bun run claude:download  # First time only
bun run dev

Harvey + Harvey-DevKit 正式联调启动

前提：Harvey-DevKit 已在 http://localhost:3000 启动并完成 saas:migrate:v1、saas:seed:v1。

  1. 启动 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
  1. 健康检查：
curl --noproxy '*' http://localhost:8787/health
curl --noproxy '*' http://localhost:3000/api/health
  1. 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"}}'
  1. 查看积分是否扣减（在 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 仅兼容保留。

UI 入口

  • Harvey-DevKit Web: http://localhost:3000
  • Harvey 桌面主应用: bun run dev 启动 Electron

/web/full/ 测试页面已移除，避免误用。

SaaS Smoke (Milestone 0/1)

Run the SaaS baseline + tenant-isolation smoke checks:

Optional mutation checks (consume credits):

SAAS_RUN_MUTATION=true bun run saas:smoke:m0m1

Setup details and acceptance checklist:

  • docs/SAAS_TESTING.md
  • docs/ACCEPTANCE.md

Feedback & Community

Join our Discord for support and discussions.

License

Apache License 2.0 - see LICENSE for details. This project includes third-party open source software; see THIRD_PARTY_NOTICES.md where applicable.