Quick version: Claude Code already writes a log of every session on your computer. Agent City reads that log, spots each agent and skill, and places it on a landmark. Nothing leaves your computer.
Where the data comes from
Every Claude Code session is saved as a file in ~/.claude/projects. Agent City reads those files when it starts, then watches them for new lines.
- When Claude launches an agent, a little figure walks down that landmark's line and stands there while it works.
- When the agent reports back, the figure walks home. Agents that run in the background count as working until their finish notice arrives.
- When a skill runs, its landmark flashes once.
- When Claude saves a note to your Obsidian vault, that landmark's count goes up.
What it keeps private
Only the short task title an agent is given (like "Summarize this week's readings") reaches the page. The full instructions, file contents and anything a skill was asked to do stay in the log and are never shown or sent anywhere. The server only answers requests from this computer.
How work finds its landmark
A small settings file lists each landmark and the words, skills and folders that belong to it. The first match wins, in this order: skill name, words in the task title, agent type, the note's folder, then the project folder. Anything else waits at the hub.
To move something, add a word or folder to that landmark in config/city.json and restart.
The little figures
Every figure is one agent Claude actually launched, read from your session log. What it holds shows its type: a magnifying glass for an explorer, a clipboard for a planner, a hard hat for a general helper, a notebook for a person researcher. Other types wear their first letter. Tap a figure to see its record: title, start time, project folder, how to resume that session, and which rule put it on that landmark.
The agent log
The Agent log page lists every past agent by day. Agent City also keeps its own copy of these records on your computer, so they stay even after Claude Code clears out old sessions (it deletes them after 30 days by default).
The daily note
Running npm run daily-note writes a one-page summary of the day into your vault: where the work happened, each agent and how long it took, the skills used, and links to the notes Claude saved that day.