# Snowtree

**Repository Path**: mirrors/Snowtree

## Basic Information

- **Project Name**: Snowtree
- **Description**: Snowtree 是 Databend Labs 推出的以审查为导向的工作流程，旨在确保 AI 编程会话的安全、可审计和可合并
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/snowtree
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Snowtree

Snowtree is Databend Labs' review-driven workflow for keeping AI coding sessions safe, auditable, and merge-ready.

AI generates code. You must review. You can't review everything or roll back safely.  
Snowtree fixes this with **worktree isolation**, **incremental review**, and **staging snapshots**.

![Snowtree Demo](assets/snowtree-show.gif)

## Highlights

- **Worktree isolation** – every AI session runs in its own Git worktree, so you can spike multiple ideas in parallel with zero merge headaches.
- **Incremental review loop** – review, stage, and lock in vetted changes after each AI round; subsequent rounds only diff against staged code.
- **Native CLI agents** – run Claude Code, Codex, Gemini CLI, or Kimi Code CLI directly without wrappers, meaning no extra queues or limits.
- **Stage-as-snapshot** – staged files become the canonical baseline. When you're ready, merge them back and ship the PR.

## What Snowtree Automates

- **AI agent writes code** – edits live in the isolated worktree while you review.
- **AI agent commits** – generates messages and commits the staged snapshot.
- **AI agent syncs PRs** – opens or refreshes pull requests on demand.
- **AI agent updates from `main`** – rebases/merges the latest upstream changes.
- **AI agent resolves conflicts** – fixes merge conflicts without touching staged files.

## Prerequisites

Install at least one AI coding agent:

| Agent | Install |
|-------|---------|
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `npm install -g @anthropic-ai/claude-code` |
| [Codex](https://github.com/openai/codex) | `npm install -g @openai/codex` |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` |
| [Kimi Code CLI](https://github.com/MoonshotAI/kimi-cli) | `curl -LsSf https://code.kimi.com/install.sh \| bash` |

## Install

**One-line installer (macOS/Linux):**

```bash
curl -fsSL https://raw.githubusercontent.com/databendlabs/snowtree/main/install.sh | sh
```

**Manual download:** [GitHub Releases](https://github.com/databendlabs/snowtree/releases)

| Platform | Format |
|----------|--------|
| macOS | `.dmg` (arm64, x64) |
| Linux | `.deb`, `.AppImage` (x86_64) |

## Development

```bash
make install   # Install dependencies
make run       # Start development server
make check     # Typecheck, lint, and test
make build     # Build packages
```

## Learn More

[Snowtree: Databend's Best Practices for AI-Native Development](https://www.databend.com/blog/category-engineering/snowtree/)

## License

Apache-2.0