# bytedance/deer-flow

An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.

84,639 stars · 11,867 forks · Python · MIT

Topics: agent, agentic, agentic-framework, agentic-workflow, ai, ai-agents, deep-research, harness

## Use it

### How to install deer-flow in Claude Code

1. Clone & open

```bash
git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
claude
```

2. Let Claude read it

   Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.

### How to install deer-flow in Claude Desktop

1. Clone the repository

```bash
git clone https://github.com/bytedance/deer-flow.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

### How to install deer-flow in Cursor

1. Clone & open in Cursor

```bash
git clone https://github.com/bytedance/deer-flow.git
```

2. Index & chat

   Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.

### How to install deer-flow in Codex CLI

1. Clone

```bash
git clone https://github.com/bytedance/deer-flow.git
```

2. Point Codex at it

   Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.

### How to install deer-flow in Windsurf

1. Clone & open

```bash
git clone https://github.com/bytedance/deer-flow.git
```

2. Use Cascade

   Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.

### How to install deer-flow in Cline

1. Clone the repository

```bash
git clone https://github.com/bytedance/deer-flow.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

### How to install deer-flow in VS Code

1. Clone the repository

```bash
git clone https://github.com/bytedance/deer-flow.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

---

Source: https://mcp-skills-hub.vercel.app/repos/bytedance-deer-flow · MCP Skills Hub · data as of 2026-10-28T12:31:05Z