Commandes du CLI

Les intitulés et les descriptions sont reproduits tels que lemni --help les affiche, donc en anglais. Les traduire ferait dire à cette page autre chose que ce que le lecteur a sous les yeux dans son terminal.

Sans sous-commande

Appelée seule, lemni ouvre une session interactive. Avec un prompt, elle le lui transmet.

lemni "explique-moi ce fichier"

Option	Effet
-p, --print	Print response and exit (useful for pipes)
--format <format>	Output format for headless mode (json). Only works with -p/—print flag.
--silent	Strip tags and excess whitespace from output. Only works with -p/—print flag.
--resume	Resume from last session
--fork <sessionId>	Fork from an existing session ID

Options communes

Elles s’appliquent à la session interactive et aux sous-commandes qui les partagent.

Option	Effet
--config <path>	Configuration file for the assistant (can be a file path or registry slug) Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier, oui.
--org <slug>	Organization slug to use for this session (supported only in headless mode) Sans effet ici : le registre n’est pas opéré : aucun slug ne se résout.
--readonly	Start in plan mode (read-only tools)
--auto	Start in auto mode (all tools allowed)
--verbose	Enable verbose logging
--beta-status-tool	Enable beta status tool
--rule <rule>	Add a rule (can be a file path, registry slug, or string content). Can be specified multiple times. Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier ou du texte, oui.
--mcp <slug>	Add an MCP server from the registry (slug in format ‘owner/package’). Can be specified multiple times. Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un fichier YAML qui déclare le connecteur, ou son adresse, oui.
--model <name>	Start this session on the named model, as written in your configuration (its readable name or its model id, case-insensitive). Refuses to start if no configured model answers to that name.
--prompt <prompt>	Add to the initial user message (can be a file path, registry slug, or string content). Can be specified multiple times. Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier ou du texte, oui.
--allow <tool>	Allow specified tool (overrides default policies). Can be specified multiple times.
--ask <tool>	Ask for permission before using specified tool (overrides default policies). Can be specified multiple times.
--exclude <tool>	Exclude specified tool from use (overrides default policies). Can be specified multiple times.
--agent <agent>	Load an agent: the name of a discovered agent (.lemniscate/agents/*.md in the project or ~/.lemniscate/agents/), a path to a markdown agent file, or a registry slug (‘owner/package’) Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier Markdown, ou le nom d’un agent découvert, oui.

Sous-commandes

lemni login

Authenticate with Lemniscate

lemni logout

Log out from Lemniscate

lemni ls

List recent chat sessions and select one to resume

Option	Effet
--json	Output in JSON format

lemni remote [prompt]

Open a remote session; —url joins a lemni serve you run

Option	Effet
--url <url>	Connect directly to the specified URL instead of creating a new remote environment
--id <id>	Connect to an existing remote agent by id and establish a tunnel Sans effet ici : demande le tunnel à un service central ; une installation cloisonnée refuse en nommant ce qui reste possible (lemni remote —url).
--idempotency-key <key>	Idempotency key for session management - allows resuming existing sessions
-s, --start	Create remote environment and print connection details without starting TUI
--branch <branch>	Specify the git branch name to use in the remote environment
--repo <url>	Specify the repository URL to use in the remote environment

lemni serve [prompt]

Commande masquée. Elle n’apparaît pas dans lemni --help.

Start an HTTP server with /state and /message endpoints

Option	Effet
--timeout <seconds>	Inactivity timeout in seconds (default: 300)
--port <port>	Port to run the server on (default: 8000)
--host <host>	Interface to bind to (default: 127.0.0.1, loopback only)
--id <storageId>	Upload session snapshots to Lemniscate-managed storage using the provided identifier Sans effet ici : le dépôt chez un service central ne fait pas partie de l’artefact cloisonné, qui refuse en nommant sa cause ; le drapeau garde son autre effet, il nomme la session. L’historique et le diff restent servis par ce serveur, sur GET /state et GET /diff.
--beta-upload-artifact-tool	Enable beta UploadArtifact tool for uploading screenshots, videos, and logs Sans effet ici : déposer un fichier chez un service central pour le relire ailleurs ne fait pas partie de l’artefact cloisonné : l’outil n’est pas offert au modèle et la commande dit pourquoi à son démarrage. Le contenu intégral du fichier (capture, vidéo, journal) ne quitte pas le poste, et aucune vue des artefacts n’est servie ici.

lemni remote-test [prompt]

Test remote TUI mode with a local server

Option	Effet
--url <url>	Server URL (default: http://localhost:8000)

lemni pr [prompt]

Orchestrate a complete PR workflow: branch, implement, push, create PR, self-review, CI loop. The agent always has full access to file tools (read, write, edit): that is implicit in calling this command. —yes controls workflow confirmations (push, PR creation), not file access.

Option	Effet
--yes	Skip workflow confirmations (push, PR creation)
--max-retries <n>	Max CI fix attempts (default: 5)
--guidelines <path>	Path to Markdown guidelines file for self-review
--base-branch <ref>	Base branch (default: main)
--dry-run	Show execution plan without running
--config <path>	Config file for the assistant Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier, oui.

lemni onboard [zone]

AI-designed onboarding course for a zone of this repository. Without subcommand: follow the course conversationally (resumes where you were). The model designs the course from the repo and its sources of why; every claim carries its provenance (sourced with citations, or plain code reading).

Option	Effet
--config <path>	Config file for the assistant Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier, oui.

lemni onboard review [zone]

Review the AI-designed course as the expert: pending learner questions first (answers are woven back into the course), then draft lessons one by one: validate, correct (signed block), or reject with a reason. Never a blank page.

lemni onboard check [zone]

CI guard: re-read every code anchor against today’s code. Lessons whose code moved are reopened as ‘to review’ (never declared wrong). Non-zero exit when something was reopened: a review signal, not a build failure.

lemni onboard build <paths...>

Design (or redesign) the onboarding course of a zone. Shows first where the why of this repo lives (files read, evidence found, verification act), then lets the model design. Output is versionable YAML.

Option	Effet
--label <label>	Human label of the zone (default: first path)
--sortie <file>	Output file (default: .lemniscate/onboarding//cours.yaml)
--config <path>	Config file for the assistant Sans effet ici : un identifiant de paquet ne se résout pas et arrête la session en nommant sa cause ; un chemin de fichier, oui.

lemni policy

Show the organization policy in force: every governed setting with its value and origin, where the policy came from, and the last refused read. —json prints the machine-readable report (same content).

Option	Effet
--json	Print the report as JSON

lemni diagnose

Write a diagnostic report on this machine and say where it is. Nothing is sent: read the folder, then forward it yourself if you decide to.

lemni verify-bundle <path>

Verify a signed release bundle offline before installing it. Refuses (exit 1) on a bad signature, a tampered or missing file, or a rolled-back version.

Option	Effet
--key <path>	Sovereign public key (PEM); defaults to the key shipped with the product
--current <version>	The installed version, to refuse a rollback

lemni journal [session]

Replay the record of what the agent did on this workstation, and check that nobody touched it since. With no session, lists every session journal on this machine with its chain verdict. —json prints the stored lines untouched, for a log analysis tool. —purges shows what the retention removed, and the hash of each removed journal. Exits 2 when a chain is broken, so a script can act on it.

Option	Effet
--json	Print the stored journal lines untouched
--purges	Show the purge ledger instead of the journals

lemni map [path]

Render a map of the repository: modules and their dependencies. Purely static: no model, no network call. Output is Mermaid on stdout by default. —cycles and —check-layers exit non-zero when they find something, so the map can be used in CI as an architecture guardrail.

Option	Effet
--level <level>	Node granularity: package | dir | file | symbol (default: dir)
--focus <nodeId>	Center the view on a file or symbol (V2)
--depth <n>	Neighborhood depth around —focus (default: 1)
--cycles	List import cycles only; exit 1 if any
--check-layers	List layer violations only; exit 1 if any
--pr	Map what the current branch changed (V7)
--base-ref <ref>	Base ref for —pr (default: upstream branch, else origin’s default branch)
--format <format>	Output format: mermaid | json (default: mermaid)
--max-nodes <n>	Maximum number of visible nodes (default: 15)