Configuration

lucid has no config file. A few environment variables change its behaviour, and the dream itself is plain files you commit.

Environment variables#

Variable	Default	Meaning
`LUCID_CLAIM_TTL`	`1200`	Seconds without activity from a claim’s owner before the claim lapses.
`LUCID_ROOT`	project dir	Where `.lucid/` lives, for worktrees outside the repo.
`LUCID_DEBUG`	unset	`1` logs every hook input to `.lucid/.debug.jsonl`.

Set them in the environment Claude Code starts in, for example:

In your terminal

LUCID_DEBUG=1 claude

One more variable belongs to Claude Code rather than lucid: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 turns on Agent Teams.

What to commit#

Commit plan.md, log.jsonl and digest.md so teammates and future sessions share the dream. Per-agent state is git-ignored automatically by the .gitignore that lucid init writes inside .lucid/.

Commit	Ignored
`plan.md`, `log.jsonl`, `digest.md`, `.gitignore`, `.gitattributes`	`.state/`, `.plan.prev`, `.debug.jsonl`, `*.tmp`