CLI and MCP
ljos is the seat. Habitats keep their own CLIs. The ticket stays open until vissue closes it.
CLI
| Verb | Habitat | Does |
|---|---|---|
ljos sitting ID | seat | Open: doctor, cards, due, island, blockers, playbook, recall, timeline, reclaim, claim. Panel after playbook on a decision. Sync after doctor only when .ljos/sync.toml names a scope. |
ljos finish ID | seat | Close: remember, fire, complete, learn. The ticket stays open. |
ljos remember TEXT | packset | POST one explicit claim. Starts the writer when none is answering. PACKSET_URL=off is no pack. |
ljos prefer TEXT | packset | Same write path, kind preference. |
ljos search QUERY | packset | Retrieve standing knowledge. |
ljos evidence ACCESSION | deedar | Frozen product bytes. |
ljos current ACCESSION | deedar | Current pointer. |
ljos deed ID [--add ACCESSION] | tracker | Cite. The bytes stay in deedar. Crate: vissue. |
ljos recall ID | tracker | Working set. |
ljos vote ID [--for CHOICE] | tracker | Ballots. |
ljos claim NODE | claimdag | This-session CAS. |
ljos complete NODE | claimdag | The ticket stays open. |
ljos hook | policyd, pack | On PreToolUse: TCB then pack rules; a deny blocks and a force push asks. On a prompt: pack text. |
ljos cards | cards | Read USER.md / MEMORY.md. Never writes. |
ljos policy -- ARGV | policyd | Prints the argv verdict. Runs nothing. A force push asks. |
ljos consensus ID | consensus crate | DeGroot / ODE over the ballots. --compare also runs vissue consensus. |
MCP
ljos-mcp execs ljos. Tool names match the verbs, including ljos_vote.
| Tool | Arguments | Does |
|---|---|---|
ljos_remember | text | Standing knowledge. Never extract-on-write. |
ljos_prefer | text | Standing preference. Never extract-on-write. |
ljos_search | query | Retrieve via PACKSET_URL. |
ljos_evidence | accession | deedar evidence. |
ljos_current | accession | deedar current tip. |
ljos_deed | issue, optional add | Cite an accession on a tracker node. |
ljos_recall | issue | Working set. |
ljos_claim | node | Claim a claimdag node. |
ljos_complete | node | Complete a claimdag node. The ticket stays open. |
ljos_cards | — | Read-only cards. |
ljos_policy | argv | Prints the argv verdict. Runs nothing. |
ljos_consensus | id | ljos-consensus over the ballots. --compare also runs the tracker verb. |
Install the seat
curl -fsSLO https://github.com/leidarljos/ljos/releases/latest/download/install.sh && sh install.sh
Crate sites: ljos · packset · deedar · vissue · claimdag · consensus · ljos-policyd