Tessera — Retrospectivas Cross-Session para Agentes de IA
annasba07/tessera
Retrospectivas semanais + coach em tempo real para otimizar uso de agentes de IA
Ver no GitHubFerramenta que analisa sessões locais de Claude Code, Codex e Gemini CLI, extrai padrões de comportamento e desperdício em um dashboard HTML interativo. Inclui um coach em tempo real que nudge o modelo durante a codificação baseado em aprendizados anteriores, fechando um loop de feedback semanal-para-sessão.
Instalação
npx convez-ai annasba07/tessera1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Analisar padrões recorrentes de desperdício ou ineficiência em sessões de codificação com IA
- Identificar oportunidades de melhoria no prompt engineering e instrução de agentes
- Rastrear evolução de produtividade e qualidade semana a semana em desenvolvimento com IA
- Receber nudges contextuais durante codificação para evitar antipadrões conhecidos
Veredito

Tessera é uma solução criativa para fechar o loop entre observação e ação no uso de agentes de IA. Bem arquitetada, com dashboard legível e integração nativa com Claude Code — ideal para desenvolvedores que querem medir e melhorar iterativamente seu fluxo de trabalho com IA, embora exija disciplina na coleta de traces locais.
README
A tradução para o português deste README ainda está na fila.
tessera + tessera-live
Two complementary tools for understanding and improving how you use AI coding agents.
🔍 Live demo → (fictional data, click around in 5 seconds)

What's in this repo
| Package | What it does |
|---|---|
tessera/ | Weekly retrospective. Reads your local Claude Code, Codex, and Gemini CLI session traces, builds rich per-session narratives, then synthesizes cross-session patterns you can act on. Surfaced as an interactive HTML dashboard. |
tessera-live/ | In-session real-time coach. Watches your live Claude Code session for known waste patterns and nudges Claude when one appears. Reads your tessera ratings to tune signal-to-noise. |
The two close a feedback loop: weekly reflection produces evidence-grounded findings → you rate them in the dashboard → those ratings shape what the coach surfaces in your next session.
Quick start
# Install the CLI (also provides the coach hook binary)
pip install tessera-agents
# Run a weekly retrospective
tessera run
# Open the dashboard
open synthesis.html
# (Optional) install the in-session coach plugin
# In Claude Code:
/plugin add ./tessera-live
See each package's README for details.
Repo layout
.
├── tessera/ # Python CLI + Claude Code slash command (/tessera)
│ ├── src/tessera/ # The package source (imported by the coach hook too)
│ ├── docs/
│ │ ├── ARCHITECTURE.md
│ │ └── schema/v1.md
│ ├── tests/
│ ├── README.md
│ └── ...
├── tessera-live/ # Claude Code plugin (separate /plugin install)
│ ├── .claude-plugin/plugin.json
│ ├── hooks/hooks.json
│ └── README.md
└── .github/workflows/
└── test.yml # CI runs the tessera test suite
The coach plugin shells out to a CLI (tessera-live-hook) that ships inside the tessera Python package, so installing tessera is a prerequisite for the coach.
Status
tesserav0.4.0 — narrative + synthesis pipeline, interactive dashboard with inline rating, week-over-week timeline.tessera-livev0.4.0 — six mechanical waste-pattern rules, rating-driven nudge enrichment.
License
MIT — see tessera/LICENSE.