Native on
Codemark bookmarks code by structure, not by line number. A file:line
reference breaks the moment you add a newline above it; Codemark uses
tree-sitter to remember what you
marked (a function, a block, a type) and anchors the bookmark to that named
structure, so it still points at the right place after you refactor or reformat
around it.
That durability is what makes it useful for long agent sessions, code audits, and
keeping track of things you want to find again.
📑 Table of Contents
⚡ Use It With Your Agent
Codemark ships with a skill you can install into your coding agent. Once it's in,
the agent knows how to create and recall structural bookmarks on its own, so the
context it built up in one session is still there in the next, instead of being
rebuilt from scratch every time.
codemark install-skill --agent claude --scope user
Then just ask, in any session:
"Trace how a request flows from the HTTP router to the database. Create a
collection called request-lifecycle and bookmark each key hop: the route
handler, the auth middleware, the service layer, and the query builder. Add a
short note to each explaining its role."
Later, in a fresh session and even after the code has moved around, you or another
agent can pick the context back up:
"Load the request-lifecycle collection and walk me through it."
The bookmarks are structural, so they still resolve once the underlying code has
changed. Works with Claude Code, GitHub Copilot, Gemini CLI, and any
agent that loads .agents/skills.
What you can ask for
Once a flow lives in a collection, anyone can reuse it: you, a teammate, or the
next agent session:
- 🧭 Onboard a new engineer
"Load the request-lifecycle collection and give me a guided tour of how
this service handles a request, in the order the code runs."
- 🔎 Explain a code flow
"Bookmark the steps of the checkout flow into a checkout collection, then
summarize what each step is responsible for."
- 🐞 Hunt a bug in a known flow
"There's a bug where expired tokens are still accepted. Read the auth-flow
collection and tell me which hop is most likely responsible."
- 🔗 Relate two flows
"Compare the request-lifecycle and background-jobs collections. Where do
they share code or state, and where could they conflict?"
📘 Walkthrough: Agent Workflow Guide · Agent Skill source
🖥️ Native Dashboard (TUI)
Codemark comes with a keyboard-driven dashboard in the style of lazygit. It's
the main way to browse and manage bookmarks, collections, and tours by hand.
codemark tui
Requires a Nerd Font. The dashboard uses glyph
icons throughout, so set your terminal to a Nerd Font (e.g. JetBrainsMono Nerd Font) so they render correctly instead of showing as □ placeholders.
🎬 More demos
See the Demo Gallery for the full-size animated walkthroughs.
Themes
The TUI ships with built-in color schemes that re-theme the whole interface. Set
one in your config (tui.theme) or via the CODEMARK_TUI_THEME environment
variable; run codemark-tui --list-schemes to see what's available.
| Catppuccin Mocha | Everforest Dark |
|---|
| |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
