otty / dotfiles

All tools/Claude Code

Claude Code

claude-code

Anthropic's coding agent, running in the terminal.

Detected by claude | macOS, Linux, Windows |claude.com

Sync it claude-code.toml

Sync rules

What travels, what stays, what never leaves

Synced6 paths, copied whole to your other machines

~/.claude/settings.json

~/.claude/CLAUDE.md

~/.claude/keybindings.json

~/.claude/agents/directory

~/.claude/commands/directory

~/.claude/skills/directory

Never synced2 credential paths, never uploaded in any form

~/.claude.json

~/.claude/.credentials.json

Otty extracts these into your secret store instead of syncing the files, apart from the keys listed under “Only these keys sync”. Every generated manager config below leaves them out too.

Secret fieldsInside a file that otherwise syncs

~/.claude.jsonjson fields at

mcpServers.*.envmcpServers.*.headers

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Stays on this machineInside a file that otherwise syncs

~/.claude/settings.jsonjson fields at

hooks.*.*.hooks.*.commandstatusLine.command

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Only these keys syncEverything else in the file stays on this machine

~/.claude.jsonjson fields at

themeeditorModeverbosepreferredNotifChannelautoConnectIdeautoInstallIdeExtensionclaudeInChromeDefaultEnabledcopyFullResponsecopyOnSelectdefaultToAgentsViewdiffToolexternalEditorContextleftArrowOpensAgentsprStatusFooterEnabledmcpServers

Otty uploads these keys and nothing else — the file is a credential, and the rest of it, sign-in included, never leaves the machine. What comes down is written around whatever this machine already has.

Excluded25 paths, state rather than configuration — never uploaded

~/.claude/settings.local.json

~/.claude/projects/directory

~/.claude/sessions/directory

~/.claude/session-env/directory

~/.claude/jobs/directory

~/.claude/tasks/directory

~/.claude/history.jsonl

~/.claude/shell-snapshots/directory

~/.claude/file-history/directory

~/.claude/paste-cache/directory

~/.claude/downloads/directory

~/.claude/backups/directory

~/.claude/cache/directory

~/.claude/debug/directory

~/.claude/telemetry/directory

~/.claude/ide/directory

~/.claude/daemon/directory

~/.claude/plugins/directory

~/.claude/stats-cache.json

~/.claude/policy-limits.json

~/.claude/settings.json.bak

~/.claude/settings.json.backup-*pattern

~/.claude/*.logpattern

~/.claude/skills/.trash/directory

~/.claude/skills/synced/directory

Not a subtraction from the paths above: this is everything else Claude Code writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

Claude Code in your home directory Every rule on this page, by file

hooks.*.*.hooks.*.commandstatusLine.command

Each machine keeps its own copy of these.

· CLAUDE.md Sync

· keybindings.json Sync

· agents/ Sync

· commands/ Sync

· .trash/ Exclude

· synced/ Exclude

· settings.local.json Exclude

· projects/ Exclude

· sessions/ Exclude

· session-env/ Exclude

· jobs/ Exclude

· tasks/ Exclude

· history.jsonl Exclude

· shell-snapshots/ Exclude

· file-history/ Exclude

· paste-cache/ Exclude

· downloads/ Exclude

· backups/ Exclude

· cache/ Exclude

· debug/ Exclude

· telemetry/ Exclude

· ide/ Exclude

· daemon/ Exclude

· plugins/ Exclude

· stats-cache.json Exclude

· policy-limits.json Exclude

· settings.json.bak Exclude

· settings.json.backup-* Exclude

· *.log Exclude

· .credentials.json Never synced

Each machine keeps its own copy of these.

mcpServers.*.envmcpServers.*.headers

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/claude-code.tomlThe file this page is generated from

id = "claude-code"

name = "Claude Code"

homepage = "https://claude.com/claude-code"

description = "Anthropic's coding agent, running in the terminal."

icon = "theSVG:claude"

detect = ["claude"]

# ~/.claude is the user-scoped config dir. settings.json holds hooks,

# permissions and model choice; CLAUDE.md is the user's global instructions;

# agents/, commands/ and skills/ are hand-written extensions. All of it is

# worth having on the other machine.

paths = [

"~/.claude/settings.json",

"~/.claude/CLAUDE.md",

"~/.claude/keybindings.json",

"~/.claude/agents/",

"~/.claude/commands/",

"~/.claude/skills/",

]

# settings.local.json is the machine-scoped half of the settings pair, by

# Claude Code's own convention. Everything else here is transcripts, caches

# and daemon state.

exclude = [

"~/.claude/settings.local.json",

"~/.claude/projects/",

"~/.claude/sessions/",

"~/.claude/session-env/",

"~/.claude/jobs/",

"~/.claude/tasks/",

"~/.claude/history.jsonl",

"~/.claude/shell-snapshots/",

"~/.claude/file-history/",

"~/.claude/paste-cache/",

"~/.claude/downloads/",

"~/.claude/backups/",

"~/.claude/cache/",

"~/.claude/debug/",

"~/.claude/telemetry/",

"~/.claude/ide/",

"~/.claude/daemon/",

"~/.claude/plugins/",

"~/.claude/stats-cache.json",

"~/.claude/policy-limits.json",

"~/.claude/settings.json.bak",

"~/.claude/settings.json.backup-*",

"~/.claude/*.log",

# Claude Code's own state inside skills/, not the user's: synced/ holds the

# skills Claude syncs per account (it downloads them again itself, staging

# through synced/.staging/), and .trash/ is where it moves the old copies on

# each refresh.

"~/.claude/skills/.trash/",

"~/.claude/skills/synced/",

]

# ~/.claude.json is mode 0600 and carries the signed-in account plus

# per-project state; .credentials.json is the OAuth token store when Claude

# Code is not using the OS keychain.

secret = ["~/.claude.json", "~/.claude/.credentials.json"]

# Every hook is a shell command with an absolute path to a binary or script

# on this machine, and statusLine is the same. Verified against the shape

# Claude Code writes: hooks.<Event>[].hooks[].command. The commands are the

# user's own scripts, so they are worth keeping to put this machine back

# together — backup — even though the paths inside them mean nothing anywhere

# else.

[[machine_lines]]

file = "~/.claude/settings.json"

match = { key_path = ["hooks.*.*.hooks.*.command", "statusLine.command"] }

scope = "backup"

# ~/.claude.json stays a credential file — a consumer that does not read

# except_key_path keeps treating it as one — but most of it is not: Claude

# Code rewrites it many times a minute with caches, counters and per-project

# session stats. These are the settings in it worth having on the next

# machine: the global config keys of

# https://code.claude.com/docs/en/settings-reference#global-config-settings,

# the four older settings Claude Code still writes here (theme, editorMode,

# verbose, preferredNotifChannel), and user-scoped MCP servers

# (https://code.claude.com/docs/en/mcp). Everything else — the sign-in,

# projects, every cache — never leaves the machine.

[[machine_lines]]

file = "~/.claude.json"

match = { except_key_path = [

"theme",

"editorMode",

"verbose",

"preferredNotifChannel",

"autoConnectIde",

"autoInstallIdeExtension",

"claudeInChromeDefaultEnabled",

"copyFullResponse",

"copyOnSelect",

"defaultToAgentsView",

"diffTool",

"externalEditorContext",

"leftArrowOpensAgents",

"prStatusFooterEnabled",

"mcpServers",

] }

# An MCP server's env and headers are where its API keys go.

[[secret_paths]]

file = "~/.claude.json"

match = { key_path = ["mcpServers.*.env", "mcpServers.*.headers"] }

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/claude-code. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out. None of them splits hooks.*.*.hooks.*.command and statusLine.command for you — that part is Otty’s own sync, or a template you write by hand.