What is blockodile

blockodile is a native desktop window for managing your coding-agent sessions and their state. The agents themselves (Claude Code, Codex, the Cursor agent CLI, Gemini CLI, …) run as their real CLIs in real terminals, so they work exactly as in your own shell and nothing depends on blockodile. Underneath, Herdr is the runtime: it owns the sessions, persists them, detects which coding agent runs in each terminal. blockodile drives it through the herdr CLI. The three layers are explained on How it works.

Start here

What you get

• Sidebar: workspaces and terminals, drag to reorder, rename inline, a pixel icon per project.
• Agent status: the detected agent's logo per terminal (Claude, Codex, Cursor, Gemini, Copilot, Amp, opencode, Grok, pi), a spiral while it works, a green dot when done, a blue dot when it answered while you were on another terminal.
• Bento: a 12x6 grid of blocks per terminal. Drag headers to move, corners to resize, expand any block into a side drawer. Four built-in layouts plus your own saved ones.
• Keyboard: every action is a command. ⌘K opens the palette; hold ⌘ and type a number to jump to any session. Shortcuts are editable in Settings.
• Modules: blocks are folders in ~/.config/blockodile/modules/. See Modules.

Requirements

• macOS or Linux.
• Herdr installed. blockodile starts its own private Herdr server, nothing has to be running first.
• Dev: cargo run -p blockodile-app in the repo.