What it is
Two modes, one workspace
Locus runs the same taxonomy two ways. Pick one as your system of record, they do not sync.
App mode
A passphrase-locked board rendered as an artifact in Claude AI. Paste notes, triage into a portfolio, read an in-app briefing, weekly status, and pill. State lives per user in your browser.
Desk mode
File-based Locus. Your dossiers are plain markdown under a Locus/ folder; the skills read and write them. No artifact runtime needed, so it works everywhere, including Claude Cowork.
The five skills
| Skill | Say | What it does |
|---|---|---|
locus | set up locus / open locus | Front door. First-run setup, then opens App mode. |
locus-triage | triage these notes | Splits raw notes into typed records, routes each to an engagement, files it. |
locus-briefing | brief me | Reads the dossiers and writes the daily briefing. |
locus-status | weekly status | Compiles a weekly status report over a chosen window. |
locus-pill | locus pill | One idea from a 31-source canon, aimed at a live engagement. Runs only when enabled. |
Install
Add the Locus plugin
Locus installs from a plugin marketplace repository. Point your Claude environment at the repo below, then install the Locus card.
https://github.com/bradbogdan/locus-plugin
Open the Directory, then the Plugins tab.
Click + (top right) and choose Add from a repository.
Paste the repo URL above and confirm. The marketplace syncs.
Private repo: if prompted, connect the GitHub account that has access.
Find the Locus card in your Directory and click + to install. Restart the session if asked.
Open the Directory, then the Plugins tab.
Click + (top right) and choose Add from a repository.
Paste the repo URL above and confirm. The marketplace syncs.
Install the Locus card with +. The five skills register.
From a terminal with the claude CLI:
claude plugin marketplace add bradbogdan/locus-plugin
claude plugin install locus@locusRestart the session, then confirm it loaded:
claude plugin details locus # should list 5 skillsSet up
First run
Setup is a precondition, nothing runs until it is done. Say set up locus. You answer two questions and it builds the workspace.
1. Your role
Which senior seat Locus serves, for example "the COO of a regional group". Taken verbatim, it personalises every prompt. Free text, not a menu.
2. The daily pill
On or off (default off). When on, one idea from the canon each day, capped at 150 words, aimed at a live engagement.
It then writes Locus/config.md and seeds five empty engagement dossiers. Name them and give each a one-line scope before your first triage, routing quality depends on it.
Use it
Day to day
Triage
Paste raw notes. Locus splits them into typed items, routes each by scope, flags duplicates, and links completions. It shows a proposal table and waits, nothing is filed until you confirm.
Briefing
Say brief me. Leads with the single most consequential development, named by project, plus today, priorities, deadlines, risks, and one honest nudge.
Weekly status
Say weekly status. One terse paragraph per engagement over your chosen window, completed and in-progress, as a branded report.
Pill
Say locus pill. One durable idea, why it matters in two sentences, and a question put to a live engagement. Cached per day.
The look
Every briefing, status, and pill comes out in the Locus dress, navy header, magenta only where a decision needs deciding.
L O C U S
Daily Briefing
Internal — eyes onlyTop priorities
Open risks
App mode
Opening the board
In Claude AI, say open locus, the plugin renders the bundled app as a React artifact using your configured role.
window.storage for state, an LLM route for the four intelligence sites). If the intelligence sites report no AI route reachable, your artifact environment does not expose an LLM route, use Desk mode instead. Claude Cowork's HTML-only pane cannot run App mode at all.
Uninstall
Removing Locus
Open the Directory, then Plugins.
Find Locus and remove or disable it.
To fully detach, remove the locus marketplace from your sources as well.
Your Locus/ files and any App-mode browser state are yours, uninstalling the plugin does not touch them.
claude plugin uninstall locus
claude plugin marketplace remove locusGood to know
Before you rely on it
App and Desk do not sync
They start from the same empty state and diverge. Choose one as the system of record before you put real data anywhere.
The AI route is environment-dependent
App-mode intelligence needs an LLM route in the artifact runtime. Verify the briefing returns content before you depend on it.
Attachments are device-local
App-mode attachments live in your browser (IndexedDB). They are not in the markdown and not in a backup of Locus/.
Keep your Desk files
Where the working folder resets between sessions (some Claude AI containers), download the Locus/ tree at the end and re-upload next time.