Threadline

A Command Code mod that helps dyslexic developers keep their place in long coding sessions.

Long sessions are hard to hold in your head. Threadline keeps one short orientation card on screen, so you can look up and instantly see where you are.

The card

The agent keeps four fields current. Empty fields are never shown.

• Goal — what you are trying to achieve.
• Just did — the step most recently finished.
• Next — the single next action.
• Needs you — anything the agent is waiting on you for. Highlighted in yellow.

Commands

All commands live under the /threadline: group.

1. /threadline:where — show the latest card again.
2. /threadline:park <text> — set a tangent aside without losing your current goal.
3. /threadline:parked — list everything you have parked.
4. /threadline:pop [n] — pop a parked tangent onto your Next. Your old Next is re-parked automatically so you never lose it. With no argument, pops the latest.
5. /threadline:unpark <n> — remove a parked tangent without touching your card. /threadline:unpark all clears the list.
6. /threadline:history — a stacked timeline of your last few Threadline cards, so you can see how your focus shifted.
7. /threadline:reset — clear the card and parked list. The agent creates a fresh card next time work begins.

Cards and parked items persist in the session transcript. They survive resume and session branching — and your card reappears on its own when you come back, so you never start a session lost.

Every field shows how long ago it was updated. If a field hasn't changed in over ten minutes, it gets an asterisk — a quick "am I stuck?" signal.

How it works

1. The mod adds a threadline_update tool the agent can call.
2. A stable system-prompt note tells the agent to call it only when something material changes — never after every tool call.
3. Updates render as a short, well-spaced custom feed card. Bold labels, one idea per line, generous spacing.
4. Everything is local and deterministic. The mod never makes model requests of its own.

Install

Personal use — copy the file and reload:

cp Threadline.ts ~/.commandcode/mods/
# then run /reload in Command Code

As a package — install from this repo (GitHub):

cmd mods add mdeloughry/cmd-threadline

From npm:

cmd mods add npm:@mdeloughry/cmd-threadline

Develop

1. Edit Threadline.ts.
2. Try it without installing: cmd --mod ./Threadline.ts.
3. Run the tests: npm test (12 checks against a mock mod API — no model calls).
4. Reload with /reload to pick up changes.

License

MIT. See LICENSE.