Skip to content

馃摎 docs: (installation) replace the seed step with tapesctl sync - #342

Open
bdougie wants to merge 2 commits into
mainfrom
docs-quickstart-tapesctl-sync
Open

馃摎 docs: (installation) replace the seed step with tapesctl sync#342
bdougie wants to merge 2 commits into
mainfrom
docs-quickstart-tapesctl-sync

Conversation

@bdougie

@bdougie bdougie commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Why

The quick start went from tapes serve to tapesctl seed, so the first thing a new user saw was demo data. Anyone installing Tapes already has Claude Code sessions on disk. If they do not, they are probably not the target user. tapesctl sync pushes those sessions in, and it was only documented on the tapesctl capture page.

What changed

In docs/installation.md, the seed step is replaced with a sync step:

  • tapesctl sync --ingest-url http://localhost:8082 then tapesctl sessions list.
  • Notes that it is safe to repeat, that derivation runs in the background, and that --since-days 0 sweeps everything.
  • Links to the capture page for what a transcript-only session contains.

tapesctl seed still exists and is still documented on the commands page. It is no longer the first thing a new user is told to run.

Docs only. Renders at https://tapes.dev/docs/installation/ once synced.

Part of PCC-1305

A fresh server does not have to start empty. tapesctl sync pushes the
Claude Code transcripts already on disk, so the quick start now shows
it right after the seed step, with the async-derive caveat and a link
to the capture page for what a transcript-only session contains.
@greptile-apps

greptile-apps Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Adds a quick-start section explaining how to import existing Claude Code transcripts with tapesctl sync.

  • Shows the sync and session-list commands.
  • Documents the default seven-day window, repeat safety, asynchronous derivation, and full-history option.
  • Links readers to the detailed capture documentation.

Confidence Score: 5/5

The documentation-only change appears safe to merge.

The documented ingestion deduplication, asynchronous derivation, and local read-versus-ingest port behavior align with the repository鈥檚 current contracts, and no concrete broken workflow was established.

Important Files Changed

Filename Overview
docs/installation.md Adds concise installation guidance for syncing existing Claude Code sessions; no actionable issue was established.

Reviews (1): Last reviewed commit: "馃摎 docs: (installation) show tapesctl sy..." | Re-trigger Greptile

Someone installing Tapes already has Claude Code sessions on disk, so
the quick start should fill the server with those instead of demo
data. tapesctl seed stays available; it is just no longer the first
thing a new user is told to run.
@bdougie bdougie changed the title 馃摎 docs: (installation) show tapesctl sync in the quick start 馃摎 docs: (installation) replace the seed step with tapesctl sync Sep 3, 2026
@linear-code

linear-code Bot commented Sep 3, 2026

Copy link
Copy Markdown

PCC-1305

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant