octop 0.1.0.dev0__tar.gz

octop-0.1.0.dev0/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+dist/
+build/
+*.sqlite
+*.sqlite-journal
+*.db
+*.db-wal
+*.db-shm
+.coverage
+htmlcov/
+node_modules/
+dashboard/dist/
+src/orca/dashboard/*
+!src/orca/dashboard/__init__.py
+!src/orca/dashboard/index.html
+!src/orca/dashboard/.gitkeep

octop-0.1.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrcaKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

octop-0.1.0.dev0/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: octop
+Version: 0.1.0.dev0
+Summary: Multi-user, multi-Agent self-hosted AI server built on harness-agent
+Author: octop contributors
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: acme>=5.6.0
+Requires-Dist: agent-client-protocol>=0.9.0
+Requires-Dist: apscheduler<4,>=3.10
+Requires-Dist: argon2-cffi>=23.1
+Requires-Dist: click>=8.1
+Requires-Dist: cos-python-sdk-v5>=1.9
+Requires-Dist: cryptography>=41
+Requires-Dist: edge-tts>=6.1
+Requires-Dist: fastapi>=0.110
+Requires-Dist: harness-agent
+Requires-Dist: harness-im-bridge
+Requires-Dist: josepy>=2.2.0
+Requires-Dist: langfuse>=4.9.0
+Requires-Dist: psutil>=5.9
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyjwt>=2.8
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.7
+Requires-Dist: scalar-fastapi>=1.0
+Requires-Dist: segno>=1.6
+Requires-Dist: uvicorn[standard]>=0.27
+Requires-Dist: websockets>=13.0
+Provides-Extra: browser
+Requires-Dist: harness-browser; extra == 'browser'
+Requires-Dist: playwright>=1.40; extra == 'browser'
+Provides-Extra: channels-feishu
+Requires-Dist: harness-browser>=0.1.0; extra == 'channels-feishu'
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<h1 align="center">Octop</h1>
+
+<p align="center">
+  <strong>Multi-user, multi-Agent self-hosted AI server — one process, no external queue.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.python.org/downloads/"><img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white" /></a>
+  <a href="https://github.com/orcakit/orca/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green" /></a>
+  <a href="https://github.com/orcakit/orca/releases"><img alt="Version" src="https://img.shields.io/badge/version-0.1.0-orange" /></a>
+  <a href="https://pypi.org/project/octop/"><img src="https://img.shields.io/pypi/v/octop" alt="PyPI" /></a>
+  <a href="https://github.com/orcakit/orca"><img alt="GitHub stars" src="https://img.shields.io/github/stars/orcakit/orca?style=social" /></a>
+</p>
+
+<p align="center">
+  <b>English</b> · <a href="README_CN.md">中文</a>
+</p>
+
+---
+
+**Octop** is an open-source, self-hosted AI control plane built on the [Harness](https://github.com/orcakit) agent stack. One Python process runs the dashboard, CLI, IM channels, cron jobs, and multi-user agent runtime — no external queue required.
+
+Chat through the Web Dashboard, Feishu, DingTalk, QQ, Discord, WeCom, or programmatic HTTP/SSE. Extend capabilities with the **expert library**, **Connectors** (OAuth + MCP), and **ACP** integration for IDE workflows.
+
+## ✨ Highlights
+
+| | Feature | Description |
+|---|---------|-------------|
+| 👥 | **Multi-user expert team** | One admin, shared household; built-in expert library and MBTI personas — switch roles per scenario |
+| 🔌 | **Connector ecosystem** | Tencent suite (Docs, Weibo trends, News, …); OAuth and MCP gateway extend resource boundaries |
+| 💾 | **Pluggable backends** | Local disk, Docker containers, PostgreSQL, or COS/S3 — AI operates inside isolated boundaries |
+| 🧠 | **Portable memory** | Powered by [harness-memory](https://github.com/orcakit/harness-memory); memory migrates with the workspace |
+| ↔️ | **ACP bidirectional** | `octop acp` for IDE/terminal AI; delegate to OpenCode / Claude Code with permission gates |
+| 🏠 | **Single-process self-hosted** | Dashboard, CLI, IM channels, and cron in one `octop run` — all data under `~/.octop/` |
+
+## 🏗️ Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| **Language** | Python 3.11+ |
+| **Web framework** | FastAPI + uvicorn |
+| **Agent runtime** | [harness-agent](https://github.com/orcakit/harness-agent) + LangGraph |
+| **IM bridge** | [harness-im-bridge](https://github.com/orcakit/harness-im-bridge) |
+| **Control plane DB** | SQLite (WAL) via aiosqlite |
+| **Frontend** | React 18 + TypeScript + Vite + Ant Design |
+| **Scheduling** | APScheduler |
+| **ACP** | agent-client-protocol |
+| **Build / quality** | hatchling · ruff · mypy · pytest |
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python **3.11+**
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+
+### Install & run
+
+```bash
+pip install octop
+octop init        # interactive bootstrap: DB, JWT secret, first admin
+octop run         # serve dashboard + API on :8088
+open http://127.0.0.1:8088
+```
+
+Optional browser automation:
+
+```bash
+pip install "octop[browser]"
+```
+
+### Docker (recommended for production)
+
+```bash
+# Build and start
+docker compose -f deploy/docker-compose.yml up -d
+
+# Or build manually
+bash deploy/docker_build.sh
+docker run -d \
+  -p 8088:8088 \
+  -v octop-data:/data/.octop \
+  -e HOME=/data \
+  -e OCTOP_DEFAULT_PASSWORD=changeme \
+  octop:latest
+```
+
+Open `http://localhost:8088` — default credentials are `admin` / `octop` (change immediately).
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OCTOP_PORT` | `8088` | HTTP listen port |
+| `OCTOP_DEFAULT_PASSWORD` | `octop` | First-run admin password |
+| `OCTOP_ADMIN_USERNAME` | `admin` | First-run admin username |
+| `OCTOP_DATA` | `~/.octop` | Host data directory (compose bind mount) |
+
+See [`.env.example`](.env.example) for the full list.
+
+## 📦 Install options
+
+| Command | Description |
+|---------|-------------|
+| `pip install octop` | Core server — API, CLI, dashboard, IM bridge |
+| `pip install "octop[browser]"` | Adds harness-browser for remote browser sessions |
+| `bash scripts/install.sh` | One-line installer (macOS / Linux, PyPI or source) |
+
+## 🧩 Core capabilities
+
+### Server & auth
+- Multi-user JWT authentication with admin role
+- First-run setup wizard (`octop init`)
+- Interactive API docs at `/api/docs`
+
+### Agents
+- Multiple agents per user; each has its own workspace, providers, channels, and cron
+- 16 MBTI persona templates + custom system prompt
+- Expert library scanned at boot (`infra/agents/experts/library/`)
+- Workspace backends: local disk, COS, S3, and other remote stores
+
+### Channels & automation
+- IM channels: Feishu, DingTalk, QQ, Discord, WeCom, and more
+- Proactive cron jobs with natural-language and slash-command triggers
+- Unified message processing across Web UI, IM, and cron surfaces
+
+### Surfaces
+- **Web dashboard** — chat, agents, connectors, channels, cron, settings
+- **CLI** — `octop run`, `octop chat`, `octop acp`, admin commands
+- **HTTP/SSE API** — full programmatic access
+
+### ACP (Agent Client Protocol)
+
+Octop supports ACP in two directions:
+
+1. **Inbound** — external tools use **your** Octop agent
+   ```bash
+   octop acp --agent main   # stdio ACP server for Zed, OpenCode, …
+   ```
+
+2. **Outbound** — Octop delegates to external coding agents
+   - Dashboard → **ACP** (`/acp`): configure runners (global per user)
+   - Enable **acp_runner** per agent, then delegate in chat
+
+Built-in outbound runners include OpenCode, CodeBuddy, Qwen Code, Claude Code, and Codex.
+
+Full setup: **[docs/acp.md](docs/acp.md)**.
+
+## 🏗️ Architecture
+
+```
+OctopServer
+ ├─ DBPool               SQLite (WAL mode)
+ ├─ SharedServices       DI root — every repo + config
+ ├─ ExpertCatalog        scans agents/experts/library/ at boot
+ ├─ UserManager
+ │   └─ HarnessAgentManager (per user)
+ │       └─ AgentRuntime (per agent)
+ │           ├─ HarnessAgent      LangGraph runtime (harness-agent)
+ │           ├─ HarnessProcessor  IM / UI / cron entry point
+ │           ├─ ChannelManager    IM connections (harness-im-bridge)
+ │           └─ CronManager       APScheduler
+ └─ FastAPI app (uvicorn)
+```
+
+Single process. Restart rebuilds state from `~/.octop/octop.db`.
+
+See [docs/architecture.md](docs/architecture.md) and [docs/adr/001-single-process-model.md](docs/adr/001-single-process-model.md).
+
+## 📁 Project layout
+
+```
+src/octop/
+  config.py    env-var config
+  launch.py    OctopServer boot + uvicorn
+  infra/       business core (agents, gateway, cron, db, users, …)
+  api/         HTTP layer — FastAPI app, routers, JWT, SSE
+  cli/         CLI layer — Click commands
+  dashboard/   built React SPA (wheel artifact)
+
+dashboard/     frontend source (Vite) — edit here, run make build-frontend
+
+deploy/        Docker Compose, entrypoint, build & deploy scripts
+tests/         unit/ + integration/
+```
+
+## 🛠️ Development
+
+**Prerequisites:** Python 3.11+, Node 18+, [uv](https://docs.astral.sh/uv/)
+
+```bash
+# Backend
+make install          # pip install -e ".[dev]"
+make all              # lint + typecheck + test (ship bar)
+
+# Frontend (separate terminal)
+make dev-frontend     # Vite dev server on :5173
+make build-frontend   # production build → src/octop/dashboard/
+cd dashboard && npx tsc --noEmit
+```
+
+Individual targets: `make test`, `make lint`, `make typecheck`, `make format`.
+
+## 📖 Documentation
+
+| Doc | Contents |
+|-----|----------|
+| [docs/architecture.md](docs/architecture.md) | Layered diagram, process model |
+| [docs/configuration.md](docs/configuration.md) | `~/.octop/` layout, env vars |
+| [docs/acp.md](docs/acp.md) | ACP inbound and outbound |
+| [docs/api.md](docs/api.md) | Every route, body, error code |
+| [docs/cli.md](docs/cli.md) | Every CLI subcommand |
+| [docs/personas.md](docs/personas.md) | 16 MBTI templates |
+| [docs/adr/](docs/adr/) | Architecture Decision Records |
+| [AGENTS.md](AGENTS.md) | Guide for AI coding agents |
+
+## 🔒 Security & privacy
+
+- **Local-first**: Config, chats, workspaces, and credentials live under `~/.octop/` on your machine.
+- **Multi-user isolation**: JWT auth with per-user agents and workspaces.
+- **Tool guardrails**: User-editable shell command rules under `~/.octop/security/tool_guard/`.
+- **No vendor lock-in**: Swap LLM providers, storage backends, and channels without rewriting agents.
+
+## 🤝 Contributing
+
+Contributions are welcome:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Run `make all` before submitting
+4. Open a Pull Request
+
+See [AGENTS.md](AGENTS.md) for module boundaries and coding conventions.
+
+## 📋 Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.
+
+## 🔗 Related projects
+
+| Project | Description |
+|---------|-------------|
+| [harness-agent](https://github.com/orcakit/harness-agent) | LangGraph agent runtime — model routing, tools, skills, checkpointing |
+| [harness-im-bridge](https://github.com/orcakit/harness-im-bridge) | Multi-platform IM channel bridge |
+| [harness-memory](https://github.com/orcakit/harness-memory) | Hierarchical recall and FTS search |
+| [harness-browser](https://github.com/orcakit/harness-browser) | CDP browser automation with persistent profiles |
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).
+
+---
+
+<p align="center">
+  Made with ❤️ by the OrcaKit team
+</p>

octop-0.1.0.dev0/README.md

@@ -0,0 +1,254 @@
+<h1 align="center">Octop</h1>
+
+<p align="center">
+  <strong>Multi-user, multi-Agent self-hosted AI server — one process, no external queue.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.python.org/downloads/"><img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white" /></a>
+  <a href="https://github.com/orcakit/orca/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green" /></a>
+  <a href="https://github.com/orcakit/orca/releases"><img alt="Version" src="https://img.shields.io/badge/version-0.1.0-orange" /></a>
+  <a href="https://pypi.org/project/octop/"><img src="https://img.shields.io/pypi/v/octop" alt="PyPI" /></a>
+  <a href="https://github.com/orcakit/orca"><img alt="GitHub stars" src="https://img.shields.io/github/stars/orcakit/orca?style=social" /></a>
+</p>
+
+<p align="center">
+  <b>English</b> · <a href="README_CN.md">中文</a>
+</p>
+
+---
+
+**Octop** is an open-source, self-hosted AI control plane built on the [Harness](https://github.com/orcakit) agent stack. One Python process runs the dashboard, CLI, IM channels, cron jobs, and multi-user agent runtime — no external queue required.
+
+Chat through the Web Dashboard, Feishu, DingTalk, QQ, Discord, WeCom, or programmatic HTTP/SSE. Extend capabilities with the **expert library**, **Connectors** (OAuth + MCP), and **ACP** integration for IDE workflows.
+
+## ✨ Highlights
+
+| | Feature | Description |
+|---|---------|-------------|
+| 👥 | **Multi-user expert team** | One admin, shared household; built-in expert library and MBTI personas — switch roles per scenario |
+| 🔌 | **Connector ecosystem** | Tencent suite (Docs, Weibo trends, News, …); OAuth and MCP gateway extend resource boundaries |
+| 💾 | **Pluggable backends** | Local disk, Docker containers, PostgreSQL, or COS/S3 — AI operates inside isolated boundaries |
+| 🧠 | **Portable memory** | Powered by [harness-memory](https://github.com/orcakit/harness-memory); memory migrates with the workspace |
+| ↔️ | **ACP bidirectional** | `octop acp` for IDE/terminal AI; delegate to OpenCode / Claude Code with permission gates |
+| 🏠 | **Single-process self-hosted** | Dashboard, CLI, IM channels, and cron in one `octop run` — all data under `~/.octop/` |
+
+## 🏗️ Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| **Language** | Python 3.11+ |
+| **Web framework** | FastAPI + uvicorn |
+| **Agent runtime** | [harness-agent](https://github.com/orcakit/harness-agent) + LangGraph |
+| **IM bridge** | [harness-im-bridge](https://github.com/orcakit/harness-im-bridge) |
+| **Control plane DB** | SQLite (WAL) via aiosqlite |
+| **Frontend** | React 18 + TypeScript + Vite + Ant Design |
+| **Scheduling** | APScheduler |
+| **ACP** | agent-client-protocol |
+| **Build / quality** | hatchling · ruff · mypy · pytest |
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python **3.11+**
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+
+### Install & run
+
+```bash
+pip install octop
+octop init        # interactive bootstrap: DB, JWT secret, first admin
+octop run         # serve dashboard + API on :8088
+open http://127.0.0.1:8088
+```
+
+Optional browser automation:
+
+```bash
+pip install "octop[browser]"
+```
+
+### Docker (recommended for production)
+
+```bash
+# Build and start
+docker compose -f deploy/docker-compose.yml up -d
+
+# Or build manually
+bash deploy/docker_build.sh
+docker run -d \
+  -p 8088:8088 \
+  -v octop-data:/data/.octop \
+  -e HOME=/data \
+  -e OCTOP_DEFAULT_PASSWORD=changeme \
+  octop:latest
+```
+
+Open `http://localhost:8088` — default credentials are `admin` / `octop` (change immediately).
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OCTOP_PORT` | `8088` | HTTP listen port |
+| `OCTOP_DEFAULT_PASSWORD` | `octop` | First-run admin password |
+| `OCTOP_ADMIN_USERNAME` | `admin` | First-run admin username |
+| `OCTOP_DATA` | `~/.octop` | Host data directory (compose bind mount) |
+
+See [`.env.example`](.env.example) for the full list.
+
+## 📦 Install options
+
+| Command | Description |
+|---------|-------------|
+| `pip install octop` | Core server — API, CLI, dashboard, IM bridge |
+| `pip install "octop[browser]"` | Adds harness-browser for remote browser sessions |
+| `bash scripts/install.sh` | One-line installer (macOS / Linux, PyPI or source) |
+
+## 🧩 Core capabilities
+
+### Server & auth
+- Multi-user JWT authentication with admin role
+- First-run setup wizard (`octop init`)
+- Interactive API docs at `/api/docs`
+
+### Agents
+- Multiple agents per user; each has its own workspace, providers, channels, and cron
+- 16 MBTI persona templates + custom system prompt
+- Expert library scanned at boot (`infra/agents/experts/library/`)
+- Workspace backends: local disk, COS, S3, and other remote stores
+
+### Channels & automation
+- IM channels: Feishu, DingTalk, QQ, Discord, WeCom, and more
+- Proactive cron jobs with natural-language and slash-command triggers
+- Unified message processing across Web UI, IM, and cron surfaces
+
+### Surfaces
+- **Web dashboard** — chat, agents, connectors, channels, cron, settings
+- **CLI** — `octop run`, `octop chat`, `octop acp`, admin commands
+- **HTTP/SSE API** — full programmatic access
+
+### ACP (Agent Client Protocol)
+
+Octop supports ACP in two directions:
+
+1. **Inbound** — external tools use **your** Octop agent
+   ```bash
+   octop acp --agent main   # stdio ACP server for Zed, OpenCode, …
+   ```
+
+2. **Outbound** — Octop delegates to external coding agents
+   - Dashboard → **ACP** (`/acp`): configure runners (global per user)
+   - Enable **acp_runner** per agent, then delegate in chat
+
+Built-in outbound runners include OpenCode, CodeBuddy, Qwen Code, Claude Code, and Codex.
+
+Full setup: **[docs/acp.md](docs/acp.md)**.
+
+## 🏗️ Architecture
+
+```
+OctopServer
+ ├─ DBPool               SQLite (WAL mode)
+ ├─ SharedServices       DI root — every repo + config
+ ├─ ExpertCatalog        scans agents/experts/library/ at boot
+ ├─ UserManager
+ │   └─ HarnessAgentManager (per user)
+ │       └─ AgentRuntime (per agent)
+ │           ├─ HarnessAgent      LangGraph runtime (harness-agent)
+ │           ├─ HarnessProcessor  IM / UI / cron entry point
+ │           ├─ ChannelManager    IM connections (harness-im-bridge)
+ │           └─ CronManager       APScheduler
+ └─ FastAPI app (uvicorn)
+```
+
+Single process. Restart rebuilds state from `~/.octop/octop.db`.
+
+See [docs/architecture.md](docs/architecture.md) and [docs/adr/001-single-process-model.md](docs/adr/001-single-process-model.md).
+
+## 📁 Project layout
+
+```
+src/octop/
+  config.py    env-var config
+  launch.py    OctopServer boot + uvicorn
+  infra/       business core (agents, gateway, cron, db, users, …)
+  api/         HTTP layer — FastAPI app, routers, JWT, SSE
+  cli/         CLI layer — Click commands
+  dashboard/   built React SPA (wheel artifact)
+
+dashboard/     frontend source (Vite) — edit here, run make build-frontend
+
+deploy/        Docker Compose, entrypoint, build & deploy scripts
+tests/         unit/ + integration/
+```
+
+## 🛠️ Development
+
+**Prerequisites:** Python 3.11+, Node 18+, [uv](https://docs.astral.sh/uv/)
+
+```bash
+# Backend
+make install          # pip install -e ".[dev]"
+make all              # lint + typecheck + test (ship bar)
+
+# Frontend (separate terminal)
+make dev-frontend     # Vite dev server on :5173
+make build-frontend   # production build → src/octop/dashboard/
+cd dashboard && npx tsc --noEmit
+```
+
+Individual targets: `make test`, `make lint`, `make typecheck`, `make format`.
+
+## 📖 Documentation
+
+| Doc | Contents |
+|-----|----------|
+| [docs/architecture.md](docs/architecture.md) | Layered diagram, process model |
+| [docs/configuration.md](docs/configuration.md) | `~/.octop/` layout, env vars |
+| [docs/acp.md](docs/acp.md) | ACP inbound and outbound |
+| [docs/api.md](docs/api.md) | Every route, body, error code |
+| [docs/cli.md](docs/cli.md) | Every CLI subcommand |
+| [docs/personas.md](docs/personas.md) | 16 MBTI templates |
+| [docs/adr/](docs/adr/) | Architecture Decision Records |
+| [AGENTS.md](AGENTS.md) | Guide for AI coding agents |
+
+## 🔒 Security & privacy
+
+- **Local-first**: Config, chats, workspaces, and credentials live under `~/.octop/` on your machine.
+- **Multi-user isolation**: JWT auth with per-user agents and workspaces.
+- **Tool guardrails**: User-editable shell command rules under `~/.octop/security/tool_guard/`.
+- **No vendor lock-in**: Swap LLM providers, storage backends, and channels without rewriting agents.
+
+## 🤝 Contributing
+
+Contributions are welcome:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Run `make all` before submitting
+4. Open a Pull Request
+
+See [AGENTS.md](AGENTS.md) for module boundaries and coding conventions.
+
+## 📋 Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.
+
+## 🔗 Related projects
+
+| Project | Description |
+|---------|-------------|
+| [harness-agent](https://github.com/orcakit/harness-agent) | LangGraph agent runtime — model routing, tools, skills, checkpointing |
+| [harness-im-bridge](https://github.com/orcakit/harness-im-bridge) | Multi-platform IM channel bridge |
+| [harness-memory](https://github.com/orcakit/harness-memory) | Hierarchical recall and FTS search |
+| [harness-browser](https://github.com/orcakit/harness-browser) | CDP browser automation with persistent profiles |
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).
+
+---
+
+<p align="center">
+  Made with ❤️ by the OrcaKit team
+</p>