# Open Agent Kit

> **OAK is in maintenance mode.** This project is no longer under active development. I have since started [Myco](https://github.com/goondocks-co/myco), a new project originally inspired by ideas explored in OAK. Myco goes beyond memory and unlocks true intelligence for your project and your team.
>
> **Moving from OAK to Myco?** See the [migration guide](https://github.com/goondocks-co/myco/blob/main/docs/migrating-from-oak.md).

[![PR Check](https://github.com/goondocks-co/open-agent-kit/actions/workflows/pr-check.yml/badge.svg)](https://github.com/goondocks-co/open-agent-kit/actions/workflows/pr-check.yml)
[![Release](https://github.com/goondocks-co/open-agent-kit/actions/workflows/release.yml/badge.svg)](https://github.com/goondocks-co/open-agent-kit/actions/workflows/release.yml)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/goondocks-co/open-agent-kit?sort=semver)
[![PyPI](https://img.shields.io/pypi/v/oak-ci?style=flat-square)](https://pypi.org/project/oak-ci/)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue?style=flat-square)](https://www.python.org/)
[![MIT License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)

**Your Team's Memory in the Age of AI-Written Code**

You architect. AI agents build. But the reasoning, trade-offs, and lessons learned disappear between sessions. OAK records the full development story — plans, decisions, gotchas, and context — creating a history that's semantically richer than git could ever be. Then autonomous OAK Agents and Skills turn that captured intelligence into better documentation, deeper insights, and ultimately higher quality software, faster.

![OAK CI Dashboard](docs/src/assets/images/dashboard-team-topo-normal.png)

```mermaid
graph LR
    A[AI Coding Agent] -->|Hooks| B[OAK Daemon]
    B -->|Context| A
    B --> C[(Memory & Code Index)]
    C --> D[OAK Agents]
    D -->|Docs · Analysis · Insights| E[Your Project]
```

<details>
<summary><strong>Legacy install (maintenance mode)</strong></summary>

## Quick Start

```bash
# Install via Homebrew (macOS)
brew install goondocks-co/oak/oak-ci
```

```bash
# Or via the install script (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/goondocks-co/open-agent-kit/main/install.sh | sh
```

```bash
# Initialize your project
oak init
```

> **Windows?** See [QUICKSTART.md](QUICKSTART.md) for PowerShell install and other methods (pipx, uv, pip).

<details>
<summary><strong>Beta / pre-release channel</strong></summary>

After installing OAK, switch to the beta channel from the daemon UI
(About dialog) or by editing `~/.oak/update.yaml`:

```yaml
update:
  channel: beta
```

The daemon will automatically check for and download pre-release versions.

</details>

Open the OAK Dashboard in your browser:

```bash
oak team start --open
```

Start coding!

```bash
claude
```

</details>

> **[Full documentation](https://openagentkit.app/)** | **[Quick Start](QUICKSTART.md)** | **[Contributing](CONTRIBUTING.md)**

## Supported Agents

| Agent | Hooks | MCP | Skills |
|-------|-------|-----|--------|
| **Claude Code** | Yes | Yes | Yes |
| **Gemini CLI** | Yes | Yes | Yes |
| **Cursor** | Yes | Yes | Yes |
| **Codex CLI** | Yes (OTel) | Yes | Yes |
| **OpenCode** | Yes (Plugin) | Yes | Yes |
| **Windsurf** | Yes | No | Yes |
| **VS Code Copilot** | Yes | Yes | Yes |

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for the contributor guide and [oak/constitution.md](oak/constitution.md) for coding standards.

## Security

See [SECURITY.md](SECURITY.md) for the vulnerability reporting policy.

## License

[MIT](LICENSE)