Run your own

The Mac quick start installs a self-contained bundle on Apple silicon, macOS 14 or newer:

curl -fsSL https://clankie.bot/install | sh
clankie

A Mac release with a published app pin also installs Clankie.app in /Applications and opens it to pair with the local service. The Mac starts with the desktop pet; the World window is opt-in. For a terminal-only install:

curl -fsSL https://clankie.bot/install | sh -s -- --no-app

Updates retain that choice. The signed companion release is not available yet, so the current installer supplies the terminal bundle only; see distribution. Linux and source checkouts do not install the app.

/setup connects a model (subscription, API key, or local runtime), then offers phone pairing, account connections, and a first agent. Only the model is required. That model can't be a Claude subscription; to talk to Clankie on your own Claude or ChatGPT plan, run clankie claude or clankie codex, which opens that harness as him (seat commands).

• Install and pair the app: the full onboarding path
• Run from source: development setup and checks
• Run on Linux: advanced self-hosting, with its own capability limits
• Release details: checksums, layout, pinning, and upgrades

Run Clankie on your Mac with your own agent subscriptions. The software is free; model providers and connected services may charge. A free Clankie account supports phone pairing, steering while your Mac is awake and the official Discord bot. Check clankie.bot for account and install availability.

What he does

You drive him. He drives the rest.

Plans the work. Hand him an outcome, not a task list. He breaks it into issues where your repo already tracks work, in Linear, GitHub issues or its own files, or in his built-in tracker, and keeps the plan true as it moves (work items).

Delegates it. When a job needs more hands he hires Claude Code, Codex, Pi, OpenCode, or Grok Build agents into real terminals in Herdr, panes you can watch and type into, and briefs them through each harness's native input. Each project can get its own lead, on your Mac or a linked PC, and leads message each other directly. New hires go to the account with capacity to spare, and builds and simulators take turns so a busy fleet doesn't grind your Mac to a halt (agent control, remote project leads, shared resources).

Owns it. He reads every report, checks it against the evidence, lands the work, and moves the issue to Done with that evidence attached. Evidence lives in its own store, not your git history (evidence store).

Improves how it gets done. He reviews every worker he leads on a schedule, flags the stalled and the drifting, and steps in. Per-issue metrics show where the time and tokens went (efficiency, metrics).

Decides as much as you let him. One autonomy dial: off, low, high or full. At high, the default, he answers his workers, decides on changes that are hard to undo, commits, pushes and closes work, and asks you before a release. Money and accounts always come to you. Under Advanced, each gate, commit, push, release rule (even "when the last release is a week old") and close is its own setting, for every project or just one. When he needs you, he leaves one ask with his recommendation (autonomy, working preferences, asks).

Works without being asked. Put a project on Auto, give it a one-line focus, and he works its backlog unprompted, waking himself up to carry long work along. The autonomy dial decides which calls he takes alone. /auto off stops everything unprompted. From his own conversations he can post into your Discord rooms: a find worth sharing, or an announcement in the server he runs. In Discord, chattiness and what wakes him set how readily he jumps in (projects on Auto).

Your right-hand man. Think out loud with him and get pushed back on, hand him drafts and pictures to make, and ask what's moving, what's stuck, and what actually landed. His persona is yours to shape, and his history, memory, and projects live in the service, so he picks up where you left off on any screen.

Goes where you are. Talk to him from his own console, or seat him in Claude Code or Codex, the terminal you already use. In the iPhone and iPad app, Messages is home, Commons shows the team as little figures, and Terminal opens the real worker panes. Pair the app with your Mac to reach him away from your desk; he stays reachable while the Mac is plugged in.

Hangs out after hours. In Discord he chats, joins voice, plays requested music, and streams his Pokémon play (from his own PokeAgents seat) through an Activity. Screen-share watching and Go Live need the separate personal-lab body (Discord media).

Is built to extend. Models, skills, and connected services are independent choices: Linear, GitHub, Gmail, Google Calendar and Drive, Discord, image and video generation, and his own browser with his own logins (browser contract). A headless CLI, an HTTP API, and an MCP bridge expose the same authorized tools to scripts and other agents (customize).

The system underneath

Clankie is one persistent service plus the clients and connections around it. His built-in agent runs on pi; worker harnesses are connections and never replace it. The host owns conversations, memory, credentials, tool authority, and device access.

• Architecture: the system diagram and request flows
• Library index: every subsystem's canonical guide
• CLI and HTTP catalog: command and route contracts

This repository holds the service, console, relay, and public contracts. The Clankie app and the hosted service are private (repository boundary).

Contribute

CONTRIBUTING.md covers the toolchain, source setup, and checks; read AGENTS.md before pointing a coding agent at the checkout. Questions go to the docs or support, and security issues to SECURITY.md.

License

Apache-2.0 except apps/vox, the native Discord media executable, which is AGPL-3.0-or-later under its own LICENSE. Third-party components retain their own licenses; see THIRD_PARTY_NOTICES.md.