Skip to content

Claude Code

The Claude Code connector installs Signet lifecycle hooks, a skills symlink, and an MCP registration. Run signet setup and select Claude Code, or rerun the Claude Code connector after an upgrade.

Location Purpose
~/.claude/settings.json Signet hook configuration
~/.claude.json Top-level mcpServers.signet registration
~/.claude/skills Symlink to the Signet workspace skills directory

Signet no longer generates ~/.claude/CLAUDE.md. Identity and memory context are delivered by the session-start hook. During installation, Signet removes only a stale CLAUDE.md that it can identify as previously generated; it does not replace user-authored files.

The connector writes hooks to ~/.claude/settings.json:

Hook Signet command Installed timeout
SessionStart signet hook session-start -H claude-code --project "$(pwd)" resolved session-start budget plus 2 seconds
UserPromptSubmit signet hook user-prompt-submit -H claude-code --project "$(pwd)" resolved prompt-submit budget plus 2 seconds
PreToolUse signet hook notifications -H claude-code --hook PreToolUse --project "$(pwd)" --hook-json 3 seconds
PreCompact signet hook pre-compaction -H claude-code --project "$(pwd)" 3 seconds
SessionEnd signet hook session-end -H claude-code 15 seconds
Stop signet hook stop -H claude-code none (async: true)

Signet identifies its own entries by a signet hook <name> -H claude-code invocation, including quoted executable paths and Node.js or Bun invocations of signet.js. An unrelated command that mentions a Signet path as an argument is not a Signet hook. Installation adds the Signet hook groups after the groups already on each event. A later installation replaces only the Signet entries, and disconnecting Claude Code removes only those entries. Hooks you add yourself stay in place. If settings.json is not valid JSON, or its hooks value is not an object, installation and disconnect stop with an error and leave the file unchanged.

The default daemon session-start budget is 15 seconds, so the default installed SessionStart timeout is 17 seconds. The connector computes this when it writes the configuration from SIGNET_SESSION_START_TIMEOUT (or the compatibility fetch-timeout variable). It does not assume a home directory or bake a personal path into the hook command.

Likewise, the prompt-submit hook uses the resolved SIGNET_PROMPT_SUBMIT_TIMEOUT plus two seconds. Existing settings are not changed until setup or connector installation runs again.

The Stop hook never delays, blocks, or continues a turn. It records the reply that ends each turn, which Claude Code passes as last_assistant_message. Claude Code runs it in the background, and signet hook stop writes no stdout. Failures are reported on stderr.

Because the hook runs in the background, a reply can be recorded after the next prompt. A successful SessionEnd import of the complete source transcript restores source order in the canonical JSONL file. The session_transcripts row appends imported content after its live content and may retain both orders. claude -p stops unfinished async hooks on exit, so its last reply can be missing until source capture records it. Disabling SessionEnd removes that source-capture path. If the evidence append commits but the projection write fails, the route returns an error; a retry finds duplicate evidence, logs the session key without content, skips the projection append, and succeeds. The row then lacks that turn. The canonical JSONL and its canonical-transcript memory artifact retain it, but source capture does not currently rebuild session_transcripts from canonical records.

Stop fires only for the main agent. The connector does not register SubagentStop, which also fires for subagents and for internal agents such as prompt suggestions and /btw, whose replies are not main-session turns.

The connector writes the stdio server to ~/.claude.json, not ~/.claude/settings.json:

{
"mcpServers": {
"signet": {
"type": "stdio",
"command": "signet-mcp",
"args": [],
"env": {}
}
}
}

See the MCP server reference for the current tool schemas. Hooks supply automatic lifecycle context; MCP tools are for agent-initiated operations.

Signet indexes Claude Code-owned memory artifacts without rewriting them into Signet-authored files. Recall surfaces expose matching entries with Claude Code provenance. Removing a native file removes it from active recall while preserving the artifact record for lineage.

When the matching skills are installed, Claude Code can use:

/remember a durable preference or decision
/recall the decision about the deployment workflow
  • Claude Code is installed and available in PATH.
  • The Signet daemon is running.
  • The connector is installed through signet setup or the Claude Code connector command.