// use cases / agent-session-search

Agent Session Search

Search across coding-agent sessions to find prior decisions, repeated failures, terminal output, implementation attempts, and reusable workflow patterns.

// who it helps

Teams that need to recover context from long or repeated agent sessions.

// the painful moment

Why this matters

Important agent context is easy to lose because it lives across chats, terminal output, local files, and partial attempts. Search needs to understand the work, not just the final commit.

What AgentPM captures

  • Searchable prompts, replies, commands, output, and extracted keyframes.
  • Conversation-level context across repos, projects, and connected machines.
  • References back to exact transcript turns for evidence review.

What teams can do

  • Find the session where a decision was made.
  • Recover a fix, command, or setup clue from previous work.
  • Identify repeated work that should become documentation or a skill.

Questions this answers

  • Have we solved this agent setup problem before?
  • Which session introduced this implementation decision?
  • Where did the agent explain a failed approach?

// fit

What AgentPM is not replacing

AgentPM does not replace code search. It searches the surrounding session history that code search and issue trackers usually miss.

A typical workflow

  1. 01Capture sessions from connected developer machines.
  2. 02Search by repo, concept, command, file, decision, or error.
  3. 03Open the notebook or insight that contains the relevant evidence.
  4. 04Promote repeated patterns into docs, skills, or team conventions.

// common questions

Questions about agent session search

Why not just search GitHub?

GitHub search finds committed code and PR discussion. AgentPM finds the agent work around the code: prompts, commands, failed attempts, decisions, and open loops that may never appear in GitHub.

Can AgentPM help with repeated agent mistakes?

Yes. Searching and reviewing sessions helps teams spot repeated friction, such as missing setup steps, flaky commands, skipped planning, or recurring review issues.

What is AgentPM?

AgentPM is an evidence layer for coding-agent work. It captures local agent sessions, makes them searchable, and helps teams understand what happened before work becomes a pull request, ticket, or review.

How is AgentPM different from LLM observability?

LLM observability usually tracks model calls, traces, cost, latency, and evals. AgentPM tracks engineering work: what agents attempted, where they got stuck, what changed, and what evidence explains the session.

Does AgentPM replace GitHub, Jira, or Linear?

No. AgentPM captures the work that happens before those systems have a clean artifact. It complements code hosts, issue trackers, and review tools with searchable session evidence.