Tools

Tool Reference

Complete reference for all GitMem MCP tools.

See More

GitMem exposes tools via the Model Context Protocol. Each tool has a canonical name and short aliases for convenience.

Core Tools (All Tiers)

Session Management

Tool	Aliases	Purpose
session_start	`gitmem-ss`, `gm-open`	Initialize session with context
session_refresh	`gitmem-sr`, `gm-refresh`	Reload context mid-session
session_close	`gitmem-sc`, `gm-close`	Close session with reflection

Memory Operations

Tool	Aliases	Purpose
recall	`gitmem-r`	Surface relevant scars before acting
confirm_scars	`gitmem-cs`, `gm-confirm`	Confirm recalled scars (APPLYING/N_A/REFUTED)
create_learning	`gitmem-cl`, `gm-scar`	Create scar/win/pattern
create_decision	`gitmem-cd`	Log architectural decision
record_scar_usage	`gitmem-rs`	Track scar application

Search and Discovery

Tool	Aliases	Purpose
search	`gitmem-search`, `gm-search`	Explore institutional memory
log	`gitmem-log`, `gm-log`	List recent learnings
analyze	`gitmem-analyze`, `gm-analyze`	Session analytics

Thread Management

Tool	Aliases	Purpose
list_threads	`gitmem-lt`, `gm-threads`	List open threads
create_thread	`gitmem-ct`, `gm-thread-new`	Create thread with dedup
resolve_thread	`gitmem-rt`, `gm-resolve`	Mark thread resolved
promote_suggestion	`gitmem-ps`, `gm-promote`	Promote suggested thread
dismiss_suggestion	`gitmem-ds`, `gm-dismiss`	Dismiss suggested thread
cleanup_threads	`gitmem-cleanup`, `gm-cleanup`	Triage by health

Multi-Agent

Tool	Aliases	Purpose
prepare_context	`gitmem-pc`, `gm-pc`	Memory payload for sub-agents
absorb_observations	`gitmem-ao`, `gm-absorb`	Capture sub-agent findings

Utility

Tool	Aliases	Purpose
graph_traverse	`gitmem-graph`, `gm-graph`	Knowledge graph traversal
archive_learning	`gitmem-al`, `gm-archive`	Archive a learning
health	`gitmem-health`, `gm-health`	Write health report
`gitmem-help`	—	Show available commands

Pro-Only Tools (Coming Soon)

These tools will be available when the Pro tier launches:

Tool	Aliases	Purpose
record_scar_usage_batch	`gitmem-rsb`	Batch scar recording
save_transcript	`gitmem-st`	Save session transcript
get_transcript	`gitmem-gt`	Retrieve transcript
search_transcripts	`gitmem-stx`, `gm-stx`	Search transcripts
cache_status	`gitmem-cache-status`, `gm-cache-s`	Cache status
cache_health	`gitmem-cache-health`, `gm-cache-h`	Cache vs remote comparison
cache_flush	`gitmem-cache-flush`, `gm-cache-f`	Force cache reload

Local Storage

How GitMem uses the local filesystem, what persists across sessions, and container deployment considerations.

absorb_observations

Capture observations from sub-agents and teammates.

On this page

Core Tools (All Tiers)Session Management Memory Operations Search and Discovery Thread Management Multi-Agent Utility Pro-Only Tools (Coming Soon)