Skip to content

[Feature]: Add read-only thread export and history search to the T3 CLI #8555

Closed as not planned

Description

@bensandison

Summary

Add a supported, read-only CLI for finding and exporting T3 Code conversations. Agents and users should not need to rediscover provider JSONL layouts or query the internal SQLite projection directly.

Problem

Common workflows need to recover an earlier thread, preview, requirement, or handoff. Today this often falls back to scanning provider transcripts with ad hoc shell scripts. Those scans can include worker copies, depend on missing utilities, and produce approximate counts.

Proposed behavior

Provide commands along these lines:

t3 history thread <uuid>
t3 history search <query>

Support lookup by thread UUID, title, project, and time. Output readable text by default and JSON on request.

Include:

  • Ordered user and assistant messages with timestamps.
  • Thread ID, exact title, project, and provider metadata.
  • Attachment references.
  • Relevant preview URLs, commits, and selected activity when available.
  • Stable deduplication of worker or subagent copies.

Keep the command read-only and build it on a supported application service rather than exposing the projection database as public API.

Acceptance criteria

  • Exporting a thread returns one canonical ordered conversation.
  • Search works across project and time filters.
  • JSON output is stable enough for agent tooling.
  • The command never mutates thread or provider state.
  • Missing or unsupported records fail without preventing other history from being searched.

Related: #1163 covers one-click transcript copying in the UI and explicitly excludes broader history management. This issue covers CLI search and agent retrieval.

Tags: enhancement, cli, history, agent-workflow

Activity

  1. t3dotgg commented on Sep 4, 2026

    @t3dotgg
    Member

    Note

    🤖 GPT-6 Astra (preview) responding on behalf of Theo

    This was closed as part of an automated cleanup pass. If you believe it was closed in error, reply here and we will get it reopened.

    Closing this as a feature proposal. Read-only thread export and history search would add new CLI commands, not repair an existing command. Please use Ideas discussions for the proposal. The read-only service boundary and stable text/JSON output requirements are useful scope for that discussion.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions