sessionio

README

agent-session-io

Harness-neutral access to local coding-agent sessions.

agent-session-io is a Go library and a single sessionio CLI for discovering, reading, exporting, indexing, and searching sessions from coding-agent harnesses. Codex and Claude Code are the first full-fidelity targets.

The core reader stays usable without SQLite, embeddings, a model provider, or a background service.

Install

macOS or Linux:

curl --proto '=https' --tlsv1.2 -fsSL \
  https://raw.githubusercontent.com/nikitatsym/agent-session-io/main/scripts/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/nikitatsym/agent-session-io/main/scripts/install.ps1 | iex

With a Go toolchain:

go install github.com/nikitatsym/agent-session-io/cmd/sessionio@latest

The release installers select the current operating system and architecture, download the latest GitHub Release archive, verify its SHA-256 checksum, and install into a user-owned directory. Set SESSIONIO_VERSION to install a specific tag or SESSIONIO_INSTALL_DIR to choose another directory.

Release archives are available for macOS, Linux, and Windows on amd64 and arm64. GitHub build provenance can be verified with:

gh attestation verify sessionio_darwin_arm64.tar.gz \
  --repo nikitatsym/agent-session-io

CLI

Fang and Cobra provide styled help, shell completion, and manpage generation:

sessionio --help
sessionio --version
sessionio version --json
sessionio completion zsh

Machine output is versioned independently of the Go module. Before 1.0, breaking Go API changes occur only in tagged minor releases.

Development

The repository requires Go, Python 3, and uv.

python3 dev.py check
uvx pre-commit install

dev.py is the single development entry point:

• python3 dev.py lint
• python3 dev.py test
• python3 dev.py e2e
• python3 dev.py check

Lint includes project-owned Go checks and uvx tackbox@latest lint .. Pre-commit and CI run the same complete dev.py check.

Release

Pushing a semantic version tag runs the complete check, builds cross-platform archives with GoReleaser, publishes checksums, and records GitHub build provenance:

git tag v0.1.0
git push origin v0.1.0

License

Mozilla Public License 2.0. See LICENSE.

Documentation

Overview

Package sessionio provides harness-neutral access to coding-agent sessions.