Your GitTok directory¶
All your files are in the GitTok directory that you made with gittok init. You can move or copy it. You can make more than one, for example one for work and one for your own projects.
~/gittok/
├── gittok.yaml marks the directory, with the gittok version
├── AGENTS.md tells the coding agent what this directory is
├── .gitignore for data/ and repos/, if you put the directory under git
├── CLAUDE.md Claude Code: points to AGENTS.md
├── .mcp.json Claude Code: starts the GitTok server
├── .claude/ Claude Code
│ ├── settings.json session hooks: the feed address, the feed watch
│ ├── skills/ gittok-generate, gittok-steer, gittok-profile-repo
│ └── agents/ gittok-writer, gittok-scout, gittok-illustrator
├── .codex/ Codex
│ ├── config.toml starts the GitTok server
│ └── hooks.json session hooks
├── .agents/ Codex
│ ├── GITTOK.md session notes
│ ├── skills/ gittok-generate, gittok-steer, gittok-profile-repo
│ └── workers/ gittok-writer, gittok-scout, gittok-illustrator
├── local/ your settings
│ ├── repos.yaml the repo list
│ ├── profiles/<repo>.yaml one profile per repo
│ ├── mascots.yaml the mascot of each repo
│ ├── guidance.md your writing guidance for the card writers
│ └── <file>.yaml optional: your changes to any default
├── data/ what GitTok makes
│ ├── gittok.db cards, what you did, what the feed learned
│ ├── assets/ card images, avatars, mascots
│ ├── memes/ meme templates and fonts
│ ├── models/ the illustration model (about 6 GB), downloaded by itself
│ ├── runs/ the brief and submissions of each run
│ ├── logs/
│ └── profile.md your taste profile in plain words, rewritten daily
└── repos/<name>/ clones of repos you added by URL
Who writes what¶
gittok initandgittok updateown the top-level files and.claude/. An update rewrites them, and keeps a file that you edited as<name>.bak.local/is yours. Your agent edits it only when you ask (or GitTok's own tools do: the repo list, profiles, mascots). An update never touches it. The Configuration reference lists every file.data/andrepos/are GitTok's. Garbage collection keeps them small: old cards you read go, saved and liked cards stay longer.
The shipped defaults, the web app and the skill sources are inside the installed gittok package, not in this directory.