CLI and MCP

ljos is the seat. Habitats keep their own CLIs. The ticket stays open until vissue closes it.

CLI

VerbHabitatDoes
ljos sitting IDseatOpen: 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 IDseatClose: remember, fire, complete, learn. The ticket stays open.
ljos remember TEXTpacksetPOST one explicit claim. Starts the writer when none is answering. PACKSET_URL=off is no pack.
ljos prefer TEXTpacksetSame write path, kind preference.
ljos search QUERYpacksetRetrieve standing knowledge.
ljos evidence ACCESSIONdeedarFrozen product bytes.
ljos current ACCESSIONdeedarCurrent pointer.
ljos deed ID [--add ACCESSION]trackerCite. The bytes stay in deedar. Crate: vissue.
ljos recall IDtrackerWorking set.
ljos vote ID [--for CHOICE]trackerBallots.
ljos claim NODEclaimdagThis-session CAS.
ljos complete NODEclaimdagThe ticket stays open.
ljos hookpolicyd, packOn PreToolUse: TCB then pack rules; a deny blocks and a force push asks. On a prompt: pack text.
ljos cardscardsRead USER.md / MEMORY.md. Never writes.
ljos policy -- ARGVpolicydPrints the argv verdict. Runs nothing. A force push asks.
ljos consensus IDconsensus crateDeGroot / ODE over the ballots. --compare also runs vissue consensus.

MCP

ljos-mcp execs ljos. Tool names match the verbs, including ljos_vote.

ToolArgumentsDoes
ljos_remembertextStanding knowledge. Never extract-on-write.
ljos_prefertextStanding preference. Never extract-on-write.
ljos_searchqueryRetrieve via PACKSET_URL.
ljos_evidenceaccessiondeedar evidence.
ljos_currentaccessiondeedar current tip.
ljos_deedissue, optional addCite an accession on a tracker node.
ljos_recallissueWorking set.
ljos_claimnodeClaim a claimdag node.
ljos_completenodeComplete a claimdag node. The ticket stays open.
ljos_cards—Read-only cards.
ljos_policyargvPrints the argv verdict. Runs nothing.
ljos_consensusidljos-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