Skip to content
Skills Library
AI & agents · Research

agentsview-usage

/agentsview-usage

Search prior session history to recall how similar work was handled before. Use when you want to leverage a past approach, check prior experience on a topic, answer "how was this handled before", or cross-verify current handling against precedent from earlier sessions.

Author
josix ↗
Repository
agent-flow ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Search prior session history to recall how similar work was handled before. Use when you want to leverage a past approach, check prior experience on a topic, answer "how was this handled before", or cross-verify current handling against precedent from earlier sessions.

Triggers from the description

how was this handled before
Original author description

Search prior session history to recall how similar work was handled before. Use when you want to leverage a past approach, check prior experience on a topic, answer "how was this handled before", or cross-verify current handling against precedent from earlier sessions.

How it works

  1. Overview
  2. When to Query Session History vs. Graph vs. Grep
  3. Tool Decision Table
  4. Token Hygiene
  5. Result Interpretation
  6. What NOT to Do
  7. Cross-References
Original SKILL.md headings · 108 lines, 875 words
SKILL.md preview
---
name: agentsview-usage
description: Search prior session history to recall how similar work was handled before. Use when you want to leverage a past approach, check prior experience on a topic, answer "how was this handled before", or cross-verify current handling against precedent from earlier sessions.
---

# AgentsView Usage

Search prior session history effectively, interpret results accurately, and stay within token budgets.

## Overview

The agentsview MCP server exposes prior AI coding agent session history (synced by the `agentsview` CLI into a local SQLite archive) as read-only search tools, started via `agentsview mcp`.

All five granted tools are accessed via the MCP prefix `mcp__plugin_agent-flow_agentsview__*`.

**Owner**: Riko (Explorer Agent) — Riko is the primary session-history search agent and owns interpretation of results.
**Consumers**:
- Senku (Planner Agent) — leverages past approaches when designing an implementation strategy: "has a similar feature been built before, and how?"
- Lawliet (Reviewer Agent) — cross-verifies current handling against precedent: "does this change match or diverge from how similar changes were handled previously?"

**Out of scope**: Loid (Executor) and Alphonse (Verifier) do NOT have agentsview access by design. This preserves the write/verify separation and keeps write/verify agents focused on the current diff and verification commands, not historical recall.

---

## When to Query Session History vs. Graph vs. Grep

| Trigger condition | Preferred approach |
|---|---|
| "How was a similar task handled before?" | AgentsView: `search_sessions` |
| "What was decided/done in a specific prior session?" | AgentsView: `get_session_overview` |
| "What exact messages/commands were used before?" | AgentsView: `get_messages` (paginated) |
| "Find prior mentions of a specific string/error/pattern" | AgentsView: `search_content` |
| "What sessions ran recently on this project?" | AgentsView: `list_sessions` |
| "What is the dependency structure of THIS project?" | Project graph (`graphify-usage`) |
| "Find the string literal `TODO: fix`" in current files | Grep |
| "What does a specific config key say in THIS project?" | Read the file directly |
| AgentsView is not available (`agentsview: available: false` in state) | Skip — proceed without session-history search |

**Rule of thumb**: AgentsView is for **recall of how prior work was actually done across past sessions**. Project graph is for **structure within this session's codebase**. Grep/Read is for **current file content**.

---

## Tool Decision Table

Choose the right tool for the question type. See [references/query-patterns.md](references/query-patterns.md) for detailed decision sequences.

| Question type | Primary tool | Follow-up |
|---|---|---|
| Find past sessions on a topic | `search_sessions` | `get_session_overview` on the best match |
| Browse recent sessions (no specific topic) | `list_sessions` | `get_session_overview` on a candidate |
| Summarize one known session | `get_session_overview` | `get_messages` if exact wording is needed |
| Read exact prior messages/commands | `get_messages` (always `limit`/paginate) | — |
| Full-text search across message/tool content | `search_content` | `get_messages` around the matched ordinal |

Note: `get_usage_summary` is intentionally **not** granted to any persona — token/cost accounting is out of scope for session-history recall.

---

## Token Hygiene

Hard rules for staying within context budget:

1. **Always set `--limit`/`limit`** on `search_sessions`, `list_sessions`, and `search_content` calls — do not request the default/max unless you need breadth.
2. **Always paginate `get_messages`**. Never fetch a whole transcript in one call; use `--around`/`--before`/`--after` or `--from` windows.
3. **Prefer `get_session_overview` or `search_content` snippets over full transcript dumps.** Only call `get_messages` when exact wording matters.
4. **Extract session IDs and short snippets only.** Do not paste raw multi-message transcripts downstream — summarize into bullet findings with session ID + one-line takeaway.
5. **Chain calls, don't parallelize blindly.** Run `search_sessions` or `search_content` first, then decide if `get_session_overview`/`get_messages` is needed for the top match.

---

## Result Interpretation

How to read and trust what AgentsView returns:

### History is a prior, not a mandate

A prior session shows how something *was* handled — not how it *must* be handled now. Requirements, codebase state, and constraints may have changed since. Always treat precedent as informative context, not binding instruction.

### Flag precedent-vs-current-requirement conflicts

When a prior session's approach conflicts with the current task's explicit requirements or constraints, surface the conflict explicitly rather than silently following either one:

```
Precedent (session <id>, <date>): used approach X.
Current requirement: approach Y is specified.
Flagging conflict for the orchestrator/user to resolve.
```

### Trust-but-verify

Session history reflects what happened in that session, not necessarily what was correct or still applies. Cross-check any recalled approach against the current codebase before relying on it — a pattern that worked in a past session may since have been refactored away or found to be wrong.

---

## What NOT to Do

- **Do not treat prior handling as binding** — a past session's approach is a data point, not a requirement.
- **Do not paste raw transcripts downstream** — summarize into session ID + snippet + takeaway; downstream agents need conclusions, not full logs.
- **Do not substitute recall for reading current files** — always verify prior approaches still apply by reading the current codebase state.
- **Do not fetch full transcripts (`get_messages` without pagination) when `search_sessions`/`get_session_overview` already answers the question.**
- **Do not call `get_usage_summary`** — it is not granted; token/cost accounting is out of scope.

---

## Cross-References

- [docs/guides/using-agentsview.md](../../docs/guides/using-agentsview.md) — setup instructions, opt-out, graceful degradation
- [references/tool-reference.md](references/tool-reference.md) — full MCP tool purposes, parameters, cost profiles
- [references/query-patterns.md](references/query-patterns.md) — decision table mapping question types to tool sequences
- [examples/worked-queries.md](examples/worked-queries.md) — end-to-end query scenarios with expected result shapes
- [skills/personal-kb-usage/SKILL.md](../personal-kb-usage/SKILL.md) — sibling skill for cross-project personal knowledge recall (notes/decisions, not session transcripts)
Files in this package (4)
  • SKILL.md 7 KB
  • examples/worked-queries.md 5 KB
  • references/query-patterns.md 3 KB
  • references/tool-reference.md 5 KB

Versions

The database has no other skills named agentsview-usage.

Database snapshot: 13.11.2026 · package version 91a1f9daa7d8 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90recall
    Search memories from past Oh My Pi sessions in the CURRENT project. Use when the user's question could benefit from historical context, past decisions, debugging notes, architectural choices, or prior conversations in this repo. For cross-project recall, use the recall-global skill instead.
  • 90recall
    Search memories from past Codex CLI sessions in the CURRENT project. Use when the user's question could benefit from historical context, past decisions, debugging notes, architectural choices, or prior conversations in this repo. For cross-project recall, use the recall-global skill instead.
  • 90recall
    Recall what was done on a specific project or topic from past AI coding sessions. Use when the user says "what did I do on [project]", "recall [topic]", "history of [project]", "when did I last work on [thing]" — but also when they reference prior work without asking for history…
  • 90session-recall
    Search the unified local history of past Claude Code, Codex, and Cursor sessions at the START of a task when the user references a prior bug, feature, decision, file, or piece of work. Use before assuming fresh context for prompts such as "remember when…", "we worked on…", "the…
  • 100session-history
    Search and summarize Claude Code, Codex, and opencode session history. Use when the user wants to look at past conversations, find sessions about a topic, or reconstruct a debugging narrative.
  • 100recall
    Session recall using qrec CLI. Invoke when the user asks about past conversations, past implementations, previous decisions, "last time we...", "how did we...", "what was the approach for...", or any question about prior work that may have been discussed in a Claude Code session.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.