Reference

Files and folders

Where LoopCode keeps your settings, conversations, memory, skills and logs — on your computer and in your project — and what is safe to commit.

In your home folder

Everything lives under ~/.loopcode (%USERPROFILE%\.loopcode on Windows), or LOOPCODE_HOME when set.

Path	Holds
`settings.json`	Your settings, for every project
`mcp.json`	Your MCP servers, for every project
`LOOPCODE.md`	Your standing instructions, for every project
`memory.md`	What you asked LoopCode to remember, everywhere
`skills/`	Your skills
`agents/`	Your custom subagents
`plugins/`	Plugins installed from LoopCode
`learned/`	Notes LoopCode learned that apply across projects
`projects/<project>/learned/`	Notes it learned about one project
`cli/`	The CLI's conversations and sign-in (`LOOPCODE_STATE` or `--state` to move it)
`vscode/`	The VS Code extension's conversations
`app/<version>/`	The installed CLI
`runtime/`	LoopCode's own Node.js, when it brought one
`logs/mcp/`	MCP servers' error output

The desktop app keeps its conversations in its application-data folder, and opens in ~/LoopCode the first time, before you choose a project.

Path	Holds	Commit it?
`LOOPCODE.md` (or `AGENTS.md`, `CLAUDE.md`)	Instructions for agents working here	Yes
`LOOPCODE.local.md`	Your own instructions for this project	No
`.loopcode/settings.json`	The team's settings: permission rules, hooks, sandbox	Yes
`.loopcode/settings.local.json`	Your settings for this project, including "always allow" answers	No
`.loopcode/mcp.json`	The project's MCP servers	Yes — keep secrets in `${VAR}` references
`.loopcode/memory.md`	What LoopCode was asked to remember about this project	Your choice
`.loopcode/skills/`	Project skills	Yes
`.loopcode/agents/`	Project subagents	Yes
`.loopcode/worktrees/`	Worktrees LoopCode created; kept out of `git status` automatically	No
`.worktreeinclude`	Ignored files to copy into new worktrees	Yes
`.github/workflows/loopcode.yml`	The GitHub integration	Yes

LoopCode also reads Claude Code's files where they exist: .claude/skills/, .claude/commands/, .claude/agents/ and .mcp.json.

A good .gitignore addition:

.gitignore

.loopcode/settings.local.json
LOOPCODE.local.md