Claude Code
What a Claude Code session materialises, the init flag that makes it the hall's provider, and how a discovery session starts there.
Setup is harness-agnostic — see the quickstart for creating a hall and opening your first session. This page covers what is specific to Claude Code once you're there.
For the end-to-end flow with this harness across repos, see Use Claude Code with multiple repositories.
What lands in .claude/
A Claude Code session materialises a .claude/ directory at the view
directory's root, alongside the promoted repos:
.claude/commands/ holds only ivar-*.md — the glob is deliberately narrow so
a user's own commands in that directory stay untouched and committable.
.claude/skills/ carries every skill from both roots — the hall's committed
skills and your personal ones — materialised under its bare id; the directory
itself is gitignored because each child is a derived symlink back into .ivar/.
CLAUDE.md is the provider-native instructions file Claude Code reads at startup.
The hall's MCP servers land beside it in .mcp.json, rewritten in full from
ivar.json on every sync — see MCP servers.
The read-only guard for repos you haven't promoted is enforced by
ivar guard --provider claude-code, registered as PreToolUse hooks in
.claude/settings.json. It's a real hook plus a real cleared write bit — not a
prompt asking the agent to behave.
Memory hooks
ivar sync also registers the memory hooks in .claude/settings.json.
ivar memory capture --provider claude-code || true runs on SessionStart,
UserPromptSubmit, PostToolUse, PostToolUseFailure and SessionEnd, and
appends each event to the hall's capture spool. ivar memory brief --provider claude-code || true runs on SessionStart and shows the open handoffs and
the count of pending messages. Both exit 0 on any error, so they never block a
prompt.
When memory.capture is false in ivar.json, ivar sync writes no
capture hook; while capture is on, ivar doctor reports a missing one as
provider.capture_hook_missing. See Hall memory.
Add it to an existing hall
The quickstart covers ivar init. If the hall already
exists with a different provider, add Claude Code alongside it:
ivar provider add claude-codeWhere ivar-explore comes from
It is a skill materialised into .claude/skills/ivar-explore/, so Claude Code
loads it from your request; there is no slash command to type.