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.
claude plugin marketplace add scodge-24/workface claude plugin install workface@workface
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
What it hooks into
session.startWhen a session startstool.callAround a tool call, where it can hold oneclassic.SessionStartA Claude Code eventsession.compactWhen the context is compactedsession.measureWhen usage is measuredcommand.runWhen you run its slash commandprompt.submitWhen you send a promptui.closeWhen its pane closesui.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
- Version
- 0.2.0
- License
- MIT
- Repo stars
- 5
- Last change
- 2026-10-04
- Language
- TypeScript
- Files
- 27