Your first session
What a session looks like from launch to exit, and where the context comes from.
Launch your host from the home (claude or codex). The SessionStart hook prints a banner: quick proof the brain is wired up.
$ cd ~/Documents/Agents/Kevin && claude
🧠 Knowledge: ~/Documents/Agents/Kevin/knowledge
📁 Projects: ~/Documents/Agents/Kevin/projects
📚 Context · 4.2KB
✓ session tail 1.6KB (YYYY-MM-DD.md)
✓ today reports 0.2KB (1 briefing)
✓ git activity 0.3KB (15 commits in the last week)
> morning briefing
[Kevin runs the morning-briefing skill: active threads, in-flight tasks, anything
overdue, what deserves attention today, with yesterday's session tail as continuity]
> Create a project called "new-blog". I want to relaunch under a different domain.
[Kevin runs create-project, scaffolds projects/new-blog/, asks for the one-line
vision, opens for your first task]
> Audit the site I have in Search Console.
[Kevin runs google-search-audit: 28 days of GSC, PageSpeed on the top 5 pages,
four rules, findings ranked by impact, report written, matching findings
threaded into open tasks]
> /exit
[The SessionEnd hook captures the conversation to knowledge/raw/sessions/,
redacting secret values first. The next compile feeds it into long-term memory.]Skills answer to plain language, as above, or to their command form: /agent-kevin:morning-briefing in Claude Code, $morning-briefing in Codex. See Hosts.
Where the context comes from
Static, loaded every session. Claude Code reads it through the @-imports in .claude/CLAUDE.md (run /context to see the cascade); Codex receives the same files in the SessionStart payload.
| File | Holds |
|---|---|
AGENTS.md | The operating manual |
SOUL.md · IDENTITY.md · USER.md | Character, role, your headline |
knowledge/index.md | Master catalog of the wiki |
knowledge/memory/index.md | Active threads, recent decisions, learnings |
projects/TASKS.md | Cross-project task dashboard |
Dynamic, injected per session by the SessionStart hook: today's date in your timezone, the last session tail, today's reports, and recent git activity, capped at 10KB.
Read on demand, never auto-loaded: user facets (knowledge/user/*.md), concept articles, and project READMEs. Kevin pulls them when relevant, which keeps the static lane lean while keeping the deeper material one read away.
Things to try
Who are you and what's on my task list?- The
quick-pulseskill for a one-minute status check - The
standupskill for your last 24 hours as did / next / blocked capture this: <a URL, a thought, a pasted note>to feed the inbox- The
syncskill when you have been away and want everything current