clerp clerp

Your assistant for T3 Code and your Mac.

Clerp is one orchestrator chat that can see every T3 thread. Give it a task and it hands longer work to a helper agent, then tells you when something needs you. It also keeps your notes and meetings in order and can tidy the windows on your desktop. You reach it from the flag on the edge of your screen.

Clerp is free to use and source available. It runs on macOS 14 or later.

The Clerp chat on a misty lilac landscape. Its header reads clerp, Working, 1 pending, Context and Open in T3. Below is a reply with two bullet points and a short JSON code block, then a line that says Not answered yet.

Talk to Clerp from the flag

Click the flag and the chat drops down under it. The chat is a local tunnel to the orchestrator chat in T3, which can see every T3 thread. Clerp hands longer work to helper agents and answers you in a line or two.

A message shows as pending until Clerp answers it. One sent while Clerp is busy waits in T3's queue and shows its place in line. Open in T3 takes you to the whole thread.

Drop or paste any file. It shows as a chip with its size and type, then goes to the chat as a file path. Pictures and files show in the messages, and a click opens Quick Look.

A send that fails stays in the chat with Retry and Remove, so nothing you typed is lost.

The strip

The strip runs under the menu bar. From left to right it shows your next meeting, your notes, what your agents are doing, your project groups, the Board and the color button. The flag sits at the right end.

Each project shows how many of its threads need you. Click any item and its list drops down right under it.

The Clerp strip under the macOS menu bar: No more meetings today, a note, Nothing running, project groups with counts, Board, and the lilac clerp flag at the right end. The chat has dropped down under the flag.
The whole strip, with the chat open under the flag. The strip is shown larger than real size. All projects and threads are demo data.

Agent timeline

On the strip, a small timeline of the last two hours sits next to how many agents are running. A status line under it moves slowly through what needs you, what is running and what just ended.

Click it for the full timeline. Clerp has the top lane, each helper it started gets its own, and every other thread gets one with its sub-agents folded in. Lanes are grouped into Waiting on you, Running, and Finished and failed in the last hour. Hover a lane to see its latest activity, or open it in T3.

The Agents timeline: 5 running, 2 waiting on you, 3 finished and 2 failed. Clerp is on the top lane, then threads waiting on you, then running threads with sage bars along a time axis.

The Board

The Board drops down under its item on the strip. Threads are in the order Needs you, Running, Failed and Done, and Done starts folded. A line at the top says what is happening right now.

Each card shows the status, the model and effort, how long the run has been going, the latest thing the agent did and its pull requests. Show details opens recent activity and the sub-agents. Click a card to open that thread in T3. The Board only reads, it never changes a thread.

The timeline gives each thread a lane with a bar for every run in the last 6 hours. A running thread with no new activity for 10 minutes says quiet. Search with Command F.

The Board in cards view, light mode. A Right now line, filters for All, Running, Needs you and Failed, two cards under Needs you, and three cards under Running, one opened to show recent activity.
Cards, with Show details open on the first running thread.
The Board in timeline view, light mode. Threads grouped under Needs you and Running, each with a lane of colored bars from 6 AM to now, and the sub-agents of one thread listed under it.
The same threads in the timeline view.

Notes and meetings

Notes sit in Today, Later and Done, in soft colors. Pop one out and it floats anywhere on the desktop, over your other windows. Agents can leave you a note by adding a line to ~/.clerp/inbox.txt, and notes are never sent to the chat.

Meetings come from macOS Calendar. The strip counts down to the next one with a Join button, and the countdown turns honey at 5 minutes. If a meeting with a video link starts and you have not joined, the strip breathes in a slow clay tint until you join or skip.

Clerp knows you joined when the call's Meet, Zoom or Teams link is open in a browser tab or a call window. If it cannot see the call, it goes by the Zoom app and the microphone.

The Clerp notes list on a warm misty landscape, with lilac and blue notes under Today and one note left by Clerp. Two of the notes are popped out as stickies beside the list.

Runs on your Mac

The flag talks to T3 on this Mac and nothing else. It reads T3's database read only and sends through T3's own t3 thread send command.

  • No open ports, no network code and no cloud relay in the flag.
  • No webhooks or new tunnels. Clerp does not use T3 Connect or LAN access.
  • Only text you type and send reaches the chat. Notes are never sent.

The orchestrator chat runs on a Claude model, so what you send it goes to Anthropic. The tunnel is local. The model is not.

Six soft colors

Pick a palette from the button on the strip. New notes take the same color. Lilac is the default. These are the real flag in each palette. Click one and this page follows.

Honey, sage and clay stay the same in every palette because they mean something.

  • Honey, soon
  • Sage, running
  • Clay, started

Build it from source

Clerp is free to use and source available. You need macOS 14 or later, the Swift toolchain from Xcode or its Command Line Tools, and T3 Code on the same Mac.

Builds are signed ad hoc, so macOS may ask for calendar access again after a rebuild.

The Clerp app icon, a lilac c with a flag on a dark rounded square.

  1. Clone the repo.

    The source link goes here when the repo is public.

  2. Build the app from the repo folder.

    ./build.sh

  3. Open it. You can copy it to Applications first.

    open build/Clerp.app
    cp -R build/Clerp.app ~/Applications/

Clerp is free to use and source available. It will live at getclerp.com.

The source link goes here when the repo is public.

Clerp for T3 Code on the Mac. Licensed under FSL-1.1-MIT, which becomes MIT two years after each release.