Tencent's Octop: Open-Source WorkBuddy Alternative Hands-On Review

Installation and Setup

Octop offers two macOS variants: a standard version and OctopPet with a desktop companion. Both trigger macOS Gatekeeper warnings because the open-source builds lack Apple notarization. The standard version is unblocked via Privacy & Security → Open Anyway. OctopPet requires stripping the quarantine attribute and ad-hoc re-signing:

xattr -cr /Applications/OctopPet.app
codesign --force --deep --sign - /Applications/OctopPet.app

The author submitted a PR to fix OctopPet launching off-screen on macOS.

Alternative installation methods include curl, pip, docker, and Tencent Cloud CVM. The curl one-liners install a WebUI version similar to DeepSeek Harness:

# macOS
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash

# Windows PowerShell
irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex

After WebUI install, access http://127.0.0.1:<port> and register locally.

Desktop Client First-Run Configuration

Login password : read octop-login.txt from the local data directory ( cat <path>).

Database : default SQLite works.

Admin account : create username/password.

Model : add any compatible LLM endpoint (author used DeepSeek).

Core Features Walk-Through

Chat Interface and History

Octop displays history in a unique card-style layout not seen in other coding agents. The default conversation partner is a General Expert (named "Xiaotong").

Experts and Teams

Experts are defined by Markdown files in a workspace directory opened via the first toolbar button. Key files include: PROFILE.md – role, description, MBTI personality SKILLS.md – prompt templates (e.g., "Planning") TOOLS.md – available tools SUB_AGENTS.md – child agents (no stated upper limit) MEMORY.md – long-term memory, emotional diary, proactive care CONNECTORS.md – external service integrations KNOWLEDGE.md – RAG knowledge base config (local or remote embedding models)

Multiple experts can be grouped into Teams (e.g., "AI Programming Mentor" + "Ops Engineer" → "Chosen Coder" team). Team membership injects a shared system prompt.

Token Accounting

Usage is broken down per expert, enabling cost tracking per role.

Skills Marketplace and Connectors

Users can create custom skill packs or import from a marketplace. Connectors mirror WorkBuddy's integration set.

Cloud Collaboration

Two Octop clients can link for cross-machine expert communication (author did not test).

Workbench

Embedded browser and terminal tabs; the browser is currently too laggy for practical use.

Remote Desktop

Bidirectional control between desktop and Android phone (iOS not supported).

ACP (Agent Communication Protocol) – Highlight Feature

ACP lets Octop delegate coding tasks to external agents: Claude Code, Codex, OpenCode, PI . Each is a Runner. Enable "Outbound Delegation", pick an expert, then invoke via prompt like:

Use acp_runner to call pi to find README and summarize

Storage Backends

Multiple persistence options configurable per expert write channel.

Enterprise-Ready Advantages

All data remains on-device; models are self-hosted or BYO-endpoint. This makes Octop a drop-in, self-hosted WorkBuddy equivalent for organizations with data-sovereignty requirements.

Verdict

Octop matches WorkBuddy feature-for-feature and adds open extensibility (sub-agents, ACP, local-first architecture). The author considers it a legitimate open-source WorkBuddy alternative and notes Tencent's growing maturity in AI tooling.