ClaudeCodeMod

All shelves / Mods / Workflow

workface

By scodge-24

workface is a Claude Code workflow mod by scodge-24.

Draws the agent's notes in a panel and hands that file back verbatim after every compaction, auto or manual.

Draws

Install

The marketplace name is workface.

In your shell
claude plugin marketplace add scodge-24/workface
claude plugin install workface@workface
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.2.0
License
MIT
Repo stars
5
Last change
2026-10-04

What it can reach

  • Draws in the session
  • Sees tool calls
  • Calls another program on this machine

Needs Claude Code v2.1.287 or later. Run /reload-plugins in a session that was open during the install. A tranche is one long piece of work, and its workface is the notes file at ~/.claude/workface/<tranche>/workface.md, at most 120 lines. /workface opens the panel. /workface start <tranche> writes a skeleton and attaches this session. The panel shows the notes as the agent writes them. Plus marks lines written since the last re-attach. The header shows the line budget, the file's age, and commits made since it was last written. Full shows exactly what the summarizer and the agent will receive. A press keeps a line out of what comes back after compaction, without touching the file, and another press puts it back. A note press writes an owner line under Owner notes. A question press puts that line on your next prompt, once, and a second press takes it back. The tabs are Compact, Full, and Browse. In fullscreen the panel docks beside the transcript, and otherwise it sits inline above the prompt. Colours follow the Claude Code theme. status_line is off by default, and turning it on adds the tranche, the line budget, the age, and commits-since to the status line. The mod makes no network requests and sends nothing anywhere. It runs date for the local time, git log for the commits-since count in the session's repo and the repos the file names, and rm to delete this session's marker on detach. What it adds for the model to read is the workface right after each compaction summary and at startup or resume, labelled as automated context, a brief to the summarizer, one reminder to update the file at 80 percent of the auto-compact threshold, one reminder to trim when the file passes 120 lines or 25 log entries, and a line you asked about, once, on your next prompt. It watches Edit, Write, and Bash only to redraw the panel, and adds a reminder after an Edit or Write that takes the file over budget. A subagent is refused. The author says it changes no settings and never alters or decides a tool call.

The plugin is the repository. The marketplace name is workface. The panel of the agent's notes is why this page files it under workflow. pin-board draws standing notes in one row above the prompt. /pin adds one. Claude gets it again after /compact and /clear. --keep stores it for the folder. compact-keeper saves a handoff file at each compaction: the token count before and after, your /compact instructions, the files edited since the last one, and the summary Claude Code wrote. This one has the agent keep its own notes file, and the panel decides which lines come back after each compaction. The README says the approach was a skill before this mod. Inside a session the README also gives /plugin install workface --marketplace scodge-24/workface. The mod's own tool refuses a bad argument.

Demo

A rendered sample of the workface panel on its Compact tab for release-2.0: 64 of 120 lines, 3 new, 1 commit since, Live state open with a new line marked plus and an omitted line struck through, and an owner note.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold one
  • classic.SessionStartA Claude Code event
  • session.compactWhen the context is compacted
  • session.measureWhen usage is measured
  • command.runWhen you run its slash command
  • prompt.submitWhen you send a prompt
  • ui.closeWhen its pane closes
  • ui.renderDraws into the sessionPane

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
scodge-24
Category
Workflow
Marketplace
workface
Repo
scodge-24/workface
Version
0.2.0
License
MIT
Repo stars
5
Last change
2026-10-04
Language
TypeScript
Files
27

Other mods in Workflow

brewmod-reminderskochetkov-maKeeps reminders as Markdown files that fire on time, draws a band of the fired ones in a later session, and has Claude run one when you pick it.navigatorqf-studioHolds a commandDraws a /nav pane of context, cost, reads, and the next task step as a button, and a phase band above the prompt, and guards fan-out reads.aftermidudevQueues prompts with /after while Claude works, draws the queue above the prompt, and sends the next one as your message when the turn ends.narratormidudevSpeaks a one or two sentence recap after each turn, in your language, with your system's best free voice, switched from the footer or /narrator.cc10xromiluz13For cc10x, which writes every workflow to disk, draws the phase, running agent, and next step above the prompt, and a pane of the whole step chain.engineerswingermanHolds a commandFor DAE, a spec- and test-driven methodology kit, draws a pipeline band and a /dae pane, and denies unconfirmed pushes and a frontier model on a loop.jevmem-paneAvinash-jetwaniFor jevmem, memory saved to JEVMEM.md, draws a side pane of what it recalled for your prompt, its guard's last call, and what it saved.vbwswt-labsHolds a commandFor VBW, which proves every requirement with a check, draws a Mission Control pane and a Comms strip, and denies risky commands during a run.project-sentinelArjun0014Holds a commandDraws a status bar above the prompt for long runs, with milestones, context, cache, and the 5-hour window, a Control Room panel, and asks before risky calls.cortexesXBlueSkyFor Cortexes, a vault of your recorded sessions, draws its session-start menu as a band above the prompt, and offers a hand-off once the context is 70% full.proof9frankbriaHolds a commandTurns a bug into a CodeFRAME requirement and checks the ledger before each git commit Claude makes, warning by default or denying in block mode.directorEvolvingAgentsLabsHolds a commandKeeps a team's way of working as linked statements Claude plans from, and draws a status line and a band to run a waiting plan or accept a lesson it learned.
All 396 in Workflow