Session

Tools for session

12 tools

codemap_audit

Check for architecture violations based on .codemap/audit-rules.json. Supports file-location, forbidden-import, text-pattern, required-annotation, and script rules with exemptions via @codemap.audit.exempt annotations.

codemap_close

Close the current session. Runs session:close scripts, saves session summary, resets group display state, and cleans up transaction log. Maintains summary history based on retention settings.

codemap_execute_shell

Execute shell commands like compile checks, npm scripts, tests, or builds. Returns stdout, stderr, and exit code. Supports different shells (cmd, powershell, bash).

codemap_help

Get help documentation for CodeMap tools and workflows. Returns formatted markdown documentation for specific topics or index of all available topics.

codemap_session_list

List archived session summaries with pagination. Shows session ID, start date, duration, and summary text for all closed sessions.

codemap_next_session

Write handoff notes to .codemap/sessions/NEXT_SESSION.md. Use to leave instructions, context, or TODOs for the next person/session working on the project.

codemap_orient

Get session orientation for the project - returns formatted markdown with project stats, session checklist, loaded parsers, and quick-start commands. Resets group display state for fresh context.

codemap_session_read

Read detailed summary for a specific session by ID. Returns full session details including all files changed, groups modified, annotations added, and complete transaction history.

codemap_reindex

Rebuild code graph. Rescans all project files to update symbol table, dependencies, and file metadata. Use after external file changes or when graph state seems stale.

codemap_session_reopen

Reopen a previously closed session to continue multi-day work. Creates new transaction log with original session ID, preserving continuity while tracking new changes.

codemap_session_start

Start a new session. Orients to the project, checks for premature termination, initializes session tracking, and loads all persistent stores (groups, labels, macros, routines, checklists).

codemap_stats

Get code graph statistics including total file count, symbol count, and dependency count. Quick project overview without full orient output.