Skip to content

Commit 8fd3e8c

Browse files
authored
docs: document the 0.39.0 release (#1277)
AgentsView 0.39.0 spans new provider support, guided semantic setup, multi-machine usage reporting, and substantial correctness and scalability work. The public documentation now matches the tagged implementation and release range, while deliberately presenting Recall and the portable artifact foundation as experimental rather than mature user workflows. The release notes absorb the shipped DuckDB mirror changes from Unreleased, call out the local-only `duckdb push` compatibility change, and acknowledge every human contributor in the range plus the artifact collaborator. Supporting guides cover the new providers, French localization, session-search age, trace context, teammate labels, daily machine breakdowns, and current Recall retrieval/evidence behavior. The new semantic-setup screenshot is generated by the Docker harness and published through the synchronized `docs-generated-assets` orphan branch, keeping binary media out of the feature branch.
1 parent 627a8af commit 8fd3e8c

32 files changed

Lines changed: 298 additions & 4477 deletions

docs/assets/hydrate-assets.sh

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ generated_assets=(
5656
"screenshots/resync-modal.png"
5757
"screenshots/search-grouped.png"
5858
"screenshots/search-results.png"
59+
"screenshots/semantic-search-setup.png"
5960
"screenshots/session-filtered.png"
6061
"screenshots/session-filters-active.png"
6162
"screenshots/session-filters.png"

docs/changelog.md

Lines changed: 119 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,20 +5,127 @@ description: Release history for AgentsView
55

66
## Unreleased
77

8+
---
9+
10+
## 0.39.0
11+
<small>2026-07-26</small>
12+
13+
**New features**
14+
15+
- Add session support for **Poolside Agent CLI**, **RooCode**, the **Kilo
16+
(legacy)** VS Code extension, and **Trae**. Trae's legacy inline-message
17+
layout is supported; modern encrypted layouts are detected and reported
18+
clearly instead of being silently skipped.
19+
- Add experimental **Recall extraction** with opt-in, scheduled local-model
20+
processing, generation management, provenance checks, lexical/vector/hybrid
21+
retrieval, and a read-only session evidence panel. Recall remains an
22+
experimental local-SQLite feature; see [Recall](/recall/) for its current
23+
limits.
24+
- Add **French localization** across the application.
25+
- Guide first-time **semantic search** setup directly in the command palette.
26+
The palette supplies configuration and restart steps, can start an embedding
27+
build, follows build progress, and retries the query when the index is ready.
28+
- Add per-machine breakdowns to `agentsview usage daily --json --breakdown`,
29+
and roll explicit subagent costs into the parent session total shown in the
30+
session header.
31+
- Show recorded **repository and worktree context** in Session Vital Signs, and
32+
add an `AGE` column to human-readable `agentsview session search` results.
33+
- Introduce an experimental portable artifact envelope and local
34+
DocBank-backed store as internal foundations for future workflows. This
35+
release does not add an export/import user workflow for the format.
36+
837
**Improvements**
938

10-
- Restrict **`duckdb push`** to the local mirror file. It no longer targets a
11-
remote Quack endpoint; configuring `[duckdb].url` now makes push fail with
12-
an error to unset it and serve the mirror remotely with
13-
`duckdb quack serve` instead. `duckdb status` and `duckdb serve` still read
14-
from a configured `[duckdb].url`.
15-
- Rebuild the **DuckDB mirror** whenever its project-filter scope changes,
16-
keeping the mirror scoped to exactly the sessions requested by the latest
17-
`--projects` / `--exclude-projects` push instead of preserving rows from an
18-
earlier, differently scoped push. The mirror is also rebuilt when it is
19-
missing or damaged, when `--full` is passed, or when the mirror's schema or
20-
the local data version no longer matches; other pushes update it
21-
incrementally.
39+
- Bound filesystem-event sync work by the changed batch, and bound Gemini
40+
reconciliation by affected roots, so passive daemon memory and work do not
41+
scale with the full archive.
42+
- Improve semantic search with role-aware query/document prefixes, automatic
43+
detection and repair of invalid stored vectors, and incremental
44+
PostgreSQL vector reconciliation.
45+
- Start analysis **Calls** details collapsed, label inline teammate messages
46+
distinctly, and assign stable, visually distinct colors across active
47+
attribution series.
48+
- Preserve Claude session identity metadata and include the recorded model in
49+
generated resume commands.
50+
- Make the API write timeout configurable and include clearer timeout details
51+
in server responses.
52+
- Simplify DuckDB into a disposable, safely rebuildable local mirror. This is a
53+
user-visible compatibility change: **`duckdb push` now writes only the local
54+
mirror file** and rejects `[duckdb].url`; `duckdb status` and `duckdb serve`
55+
can still read from a configured remote Quack endpoint. Project-filter scope
56+
changes rebuild the mirror so it exactly matches the latest push scope.
57+
58+
**Bug fixes**
59+
60+
- Fix session date filtering across browser time zones and stop persisted
61+
rolling date ranges from becoming stale.
62+
- Fix project selection when a project has an empty name, and preserve project
63+
names when opening sessions from search results.
64+
- Detect failed and invalid OpenCode tool calls correctly, and prefer the
65+
session's recorded directory over the project worktree.
66+
- Align Grok Build parsing with current persistence formats, ingest usage
67+
snapshots from `updates.jsonl`, and emit usage per turn instead of treating
68+
the last snapshot as the whole session.
69+
- Treat Copilot-reported billing as the authoritative session cost.
70+
- Preserve remote Markdown export links and keep legacy archives intact during
71+
schema repair.
72+
- Fix daemon startup readiness and preserve full-resync progress details.
73+
- Correct Poolside's Linux default directory and remove duplicate resolved
74+
Poolside targets during SSH discovery.
75+
- Fail faster when DuckDB remote endpoints are unavailable, and return
76+
actionable errors for unsupported URLs and remote schema incompatibilities.
77+
78+
**Acknowledgements**
79+
80+
- Thanks to [Wes McKinney](https://github.com/wesm) for Recall extraction,
81+
retrieval, and evidence work; the portable artifact foundation; bounded
82+
daemon sync and Gemini reconciliation; DuckDB simplification; and release
83+
documentation.
84+
- Thanks to [Matthew Jacobs](https://github.com/mjacobs) for guided semantic
85+
setup, the session-search age column, Poolside target deduplication, daemon
86+
startup reliability, Antigravity parent links, and clearer DuckDB remote
87+
failures.
88+
- Thanks to [Tyler Gibbs](https://github.com/tylergibbs1) for keeping Claude
89+
IDE context out of generated session titles.
90+
- Thanks to [ajinkyajacob](https://github.com/ajinkyajacob) for detecting
91+
invalid and failed OpenCode tool calls.
92+
- Thanks to [Stephen Cross](https://github.com/scross01) for Poolside Agent CLI,
93+
RooCode, Kilo legacy, and the corrected Poolside Linux directory.
94+
- Thanks to [Berend de Boer](https://github.com/berenddeboer) for using
95+
OpenCode's actual session directory.
96+
- Thanks to [Gabriel Mitelman Tkacz](https://github.com/gtkacz) for fixing
97+
browser-timezone session date filters.
98+
- Thanks to [Marius van Niekerk](https://github.com/mariusvniekerk) for
99+
collapsed analysis call details, repository context, Grok format alignment,
100+
invalid-vector repair, and provider-format provenance.
101+
- Thanks to [Rod Boev](https://github.com/rodboev) for Trae support, teammate
102+
labels, subagent cost rollups, project-selection fixes, Claude identity and
103+
resume-model preservation, server timeout detail, Grok usage ingestion,
104+
incremental PostgreSQL vector reconciliation, and attribution colors.
105+
- Thanks to [Daniel Delattre](https://github.com/delattre1) for correcting
106+
Grok's per-turn usage accounting.
107+
- Thanks to [TzeKei Lee](https://github.com/chikei) for parsing OhMyPi subagent
108+
transcripts as nested sessions.
109+
- Thanks to [Erik Krogen](https://github.com/xkrogen) for using
110+
Copilot-reported billing as the authoritative session cost.
111+
- Thanks to [David Riordan](https://github.com/riordan) for role-aware
112+
embedding prefixes.
113+
- Thanks to [serverless83](https://github.com/serverless83) for tracking Hermes
114+
`skill_view` usage.
115+
- Thanks to [kai](https://github.com/dpanbug) for French localization and the
116+
localized analytics model filter.
117+
- Thanks to [Phillip Cloud](https://github.com/cpcloud) for canceling obsolete
118+
frontend reads and refreshing pricing before PostgreSQL pushes.
119+
- Thanks to [Kushida](https://github.com/ShiroKSH) for preserving legacy
120+
archives during schema repair and preserving remote Markdown export links.
121+
- Thanks to [TechnoPhobe01](https://github.com/Technophobe01) for making API
122+
write timeouts configurable.
123+
- Thanks to [bangddong](https://github.com/bangddong) for fixing stale rolling
124+
session date bounds.
125+
- Thanks to [jahabdank](https://github.com/jahabdank) for Hermes profile
126+
snapshots and the SSH-sync deprecation.
127+
- Thanks to [matt wilkie](https://github.com/maphew) for collaboration on the
128+
portable artifact foundation.
22129

23130
---
24131

docs/commands.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -967,6 +967,9 @@ and `--hybrid` modes. Semantic and hybrid results can be scoped with
967967
`--scope top|all|subordinate` (default `all`) to include or exclude sidechain
968968
and subagent content — see
969969
[Semantic Search](/semantic-search/#scoping-results-scope).
970+
The human-readable table includes an `AGE` column derived from each match's
971+
timestamp, so recent evidence is visible without opening the session. Matches
972+
without a usable timestamp show ``.
970973

971974
Structured response commands accept `--format json`; `--json` is a short alias
972975
for that scripting mode. `session export` and `session watch` are the
@@ -1193,6 +1196,7 @@ agentsview help
11931196
| `HERMES_SESSIONS_DIR` | `~/.hermes/sessions` | Hermes Agent sessions directory |
11941197
| `IFLOW_DIR` | `~/.iflow/projects` | iFlow projects directory |
11951198
| `KILO_DIR` | `~/.local/share/kilo` | Kilo data directory |
1199+
| `KILO_LEGACY_DIR` | (platform-specific) | Kilo legacy VS Code extension data directory |
11961200
| `KIMI_DIR` | `~/.kimi/sessions` and `~/.kimi-code/sessions` | Kimi sessions directory |
11971201
| `KIRO_SESSIONS_DIR` | `~/.kiro/sessions/cli` and `~/.local/share/kiro-cli` | Kiro CLI sessions directory (JSONL and SQLite) |
11981202
| `KIRO_IDE_DIR` | (platform-specific) | Kiro IDE sessions directory |
@@ -1204,14 +1208,17 @@ agentsview help
12041208
| `OPENHANDS_CONVERSATIONS_DIR` | `~/.openhands/conversations` | OpenHands CLI conversations directory |
12051209
| `PI_DIR` | `~/.pi/agent/sessions` | Pi sessions directory |
12061210
| `PIEBALD_DIR` | `~/.local/share/piebald` | Piebald directory (contains `app.db`) |
1211+
| `POOLSIDE_DIR` | (platform-specific) | Poolside Agent CLI trajectory directory |
12071212
| `POSIT_ASSISTANT_DIR` | `~/.posit/assistant/workspaces` | Posit Assistant workspaces directory |
12081213
| `POSITRON_DIR` | (platform-specific) | Positron Assistant user directory |
12091214
| `QCLAW_DIR` | `~/.qclaw/agents` | QClaw agents directory |
12101215
| `QODER_PROJECTS_DIR` | `~/.qoder/projects` and `~/.qoderwork/projects` | Qoder projects directory |
12111216
| `QWEN_PROJECTS_DIR` | `~/.qwen/projects` | Qwen Code projects directory |
12121217
| `QWENPAW_DIR` | `~/.copaw/workspaces` | QwenPaw workspaces directory |
12131218
| `REASONIX_DIR` | `~/.reasonix` and `~/AppData/Roaming/reasonix` | Reasonix data directory |
1219+
| `ROOCODE_DIR` | (platform-specific) | RooCode VS Code extension data directory |
12141220
| `SHELLEY_DIR` | `~/.config/shelley` | Shelley data directory |
1221+
| `TRAE_DIR` | (platform-specific) | Trae editor user-data directory |
12151222
| `VISUALSTUDIO_COPILOT_DIR` | (platform-specific) | Visual Studio Copilot traces directory |
12161223
| `VSCODE_COPILOT_DIR` | (platform-specific) | VS Code Copilot sessions directory |
12171224
| `WINDSURF_DIR` | (platform-specific) | Windsurf user-data directory |

docs/configuration.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -573,6 +573,7 @@ export OPENCODE_DIR=~/custom/opencode
573573
export OPENHANDS_CONVERSATIONS_DIR=~/custom/openhands
574574
export PI_DIR=~/custom/pi
575575
export PIEBALD_DIR=~/custom/piebald
576+
export POOLSIDE_DIR=~/custom/poolside/trajectories
576577
export POSIT_ASSISTANT_DIR=~/custom/posit-assistant/workspaces
577578
export POSITRON_DIR=~/custom/positron
578579
export QCLAW_DIR=~/custom/qclaw
@@ -582,6 +583,7 @@ export QWENPAW_DIR=~/custom/qwenpaw
582583
export REASONIX_DIR=~/custom/reasonix
583584
export ROOCODE_DIR=~/custom/roocode
584585
export SHELLEY_DIR=~/custom/shelley
586+
export TRAE_DIR=~/custom/trae/User
585587
export VISUALSTUDIO_COPILOT_DIR=~/custom/visualstudio-copilot/traces
586588
export VSCODE_COPILOT_DIR=~/custom/vscode
587589
export WINDSURF_DIR=~/custom/windsurf/User

docs/index.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,7 @@ across every project, model, and tool.
6161
<a class="agent-chip" data-agent="antigravity" href="https://antigravity.google" target="_blank" rel="noopener"><span class="agent-chip__glyph agent-chip__glyph--mono">Ag</span><span class="agent-chip__name">Antigravity</span></a>
6262
<a class="agent-chip" data-agent="gptme" href="https://gptme.org" target="_blank" rel="noopener"><span class="agent-chip__glyph agent-chip__glyph--mono">gm</span><span class="agent-chip__name">gptme</span></a>
6363
<a class="agent-chip" data-agent="kilo" href="https://kilocode.ai" target="_blank" rel="noopener"><span class="agent-chip__glyph agent-chip__glyph--mono">Kl</span><span class="agent-chip__name">Kilo</span></a>
64+
<a class="agent-chip" data-agent="kilo-legacy" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">KL</span><span class="agent-chip__name">Kilo (legacy)</span></a>
6465
<a class="agent-chip" data-agent="kimi" href="https://www.kimi.com" target="_blank" rel="noopener"><span class="agent-chip__glyph agent-chip__glyph--mono">Km</span><span class="agent-chip__name">Kimi</span></a>
6566
<a class="agent-chip" data-agent="kiro" href="https://kiro.dev" target="_blank" rel="noopener"><span class="agent-chip__glyph agent-chip__glyph--mono">Kr</span><span class="agent-chip__name">Kiro</span></a>
6667
<a class="agent-chip" data-agent="openhands" href="https://github.com/All-Hands-AI/OpenHands" target="_blank" rel="noopener"><span class="agent-chip__glyph agent-chip__glyph--mono">OH</span><span class="agent-chip__name">OpenHands</span></a>
@@ -77,10 +78,13 @@ across every project, model, and tool.
7778
<a class="agent-chip" data-agent="openclaw" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Oc</span><span class="agent-chip__name">OpenClaw</span></a>
7879
<a class="agent-chip" data-agent="pi" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">&#960;</span><span class="agent-chip__name">Pi</span></a>
7980
<a class="agent-chip" data-agent="piebald" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Pb</span><span class="agent-chip__name">Piebald</span></a>
81+
<a class="agent-chip" data-agent="poolside" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Po</span><span class="agent-chip__name">Poolside</span></a>
8082
<a class="agent-chip" data-agent="qclaw" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Qc</span><span class="agent-chip__name">QClaw</span></a>
8183
<a class="agent-chip" data-agent="qwenpaw" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Qp</span><span class="agent-chip__name">QwenPaw</span></a>
8284
<a class="agent-chip" data-agent="reasonix" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Rx</span><span class="agent-chip__name">Reasonix</span></a>
85+
<a class="agent-chip" data-agent="roocode" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Ro</span><span class="agent-chip__name">RooCode</span></a>
8386
<a class="agent-chip" data-agent="shelley" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Sh</span><span class="agent-chip__name">Shelley</span></a>
87+
<a class="agent-chip" data-agent="trae" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Tr</span><span class="agent-chip__name">Trae</span></a>
8488
<a class="agent-chip" data-agent="workbuddy" href="/configuration/#session-discovery"><span class="agent-chip__glyph agent-chip__glyph--mono">Wb</span><span class="agent-chip__name">WorkBuddy</span></a>
8589
</div>
8690

@@ -250,9 +254,10 @@ push session data to a shared database for team or multi-machine setups.
250254
Works with [dozens of AI coding session sources](/configuration/#session-discovery)
251255
including Claude Code, OpenClaude, Codex, Copilot, Cursor,
252256
Gemini, OpenHands, Aider, Claude Cowork, DeepSeek TUI, gptme,
253-
Grok, Kilo, MiMoCode, Mistral Vibe, OhMyPi, QwenPaw, Reasonix,
254-
Shelley, Visual Studio Copilot, and ZCode. Auto-discovers session
255-
directories so there's nothing to configure.
257+
Grok, Kilo, Kilo (legacy), MiMoCode, Mistral Vibe, OhMyPi,
258+
Poolside, QwenPaw, Reasonix, RooCode, Shelley, Trae, Visual
259+
Studio Copilot, and ZCode. Auto-discovers session directories
260+
so there's nothing to configure.
256261

257262
- **Import Chat History**
258263

docs/quickstart.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -251,6 +251,7 @@ export GROK_DIR=~/custom/grok/sessions
251251
export HERMES_SESSIONS_DIR=~/custom/hermes
252252
export IFLOW_DIR=~/custom/iflow/projects
253253
export KILO_DIR=~/custom/kilo
254+
export KILO_LEGACY_DIR=~/custom/kilo-legacy
254255
export KIMI_DIR=~/custom/kimi/sessions
255256
export KIRO_SESSIONS_DIR=~/custom/kiro
256257
export KIRO_IDE_DIR=~/custom/kiro-ide
@@ -262,13 +263,16 @@ export OPENCODE_DIR=~/custom/opencode
262263
export OPENHANDS_CONVERSATIONS_DIR=~/custom/openhands
263264
export PI_DIR=~/custom/pi/sessions
264265
export PIEBALD_DIR=~/custom/piebald
266+
export POOLSIDE_DIR=~/custom/poolside/trajectories
265267
export POSITRON_DIR=~/custom/positron
266268
export QCLAW_DIR=~/custom/qclaw/agents
267269
export QODER_PROJECTS_DIR=~/custom/qoder/projects
268270
export QWEN_PROJECTS_DIR=~/custom/qwen/projects
269271
export QWENPAW_DIR=~/custom/qwenpaw
270272
export REASONIX_DIR=~/custom/reasonix
273+
export ROOCODE_DIR=~/custom/roocode
271274
export SHELLEY_DIR=~/custom/shelley
275+
export TRAE_DIR=~/custom/trae/User
272276
export VISUALSTUDIO_COPILOT_DIR=~/custom/visualstudio-copilot/traces
273277
export VSCODE_COPILOT_DIR=~/custom/vscode
274278
export WINDSURF_DIR=~/custom/windsurf/User

0 commit comments

Comments
 (0)