omnisess

README

omnisess

Aggregate AI coding sessions across Claude Code, Cursor, Codex, GitHub Copilot CLI, and Gemini — search, list, and detect active sessions from one place.

---

Install

go install github.com/psacc/omnisess@latest

The binary is named omnisess. Or build from source:

git clone https://github.com/psacc/omnisess.git
cd omnisess
go build -o omnisess .
make install  # installs binary to ~/go/bin/omnisess
make smoke    # verifies the installed binary is reachable and functional

---

Install as Claude Code Plugin

Use omnisess directly from Claude Code via slash commands — no context switching needed.

Prerequisites

The omnisess binary must be installed and in your PATH before installing the plugin:

go install github.com/psacc/omnisess@latest

Install the plugin

In Claude Code, run:

/plugin marketplace add psacc/omnisess
/plugin install omnisess@psacc

The marketplace identifier is omnisess@psacc — omnisess is the plugin name, psacc is the marketplace source added in the first command.

Usage

Once installed, seven slash commands are available:

Command	Description	Example
/omnisess:list	List all sessions across all sources	/omnisess:list --tool claude --limit 10
/omnisess:search	Full-text search across sessions	/omnisess:search "database migration"
/omnisess:active	Show currently running sessions	/omnisess:active
/omnisess:show	Show full detail for a session	/omnisess:show claude:5c3f2742
/omnisess:recap	Structured markdown briefing of sessions for a time window	/omnisess:recap today
/omnisess:ps	Live Claude process tree with ancestor lineage (macOS)	/omnisess:ps
/omnisess:skills-audit	Classify Claude Code skills by usage (Keep / Borderline / Archive)	/omnisess:skills-audit --window 90d

Each command checks for the omnisess binary at invocation time and prints clear install instructions if it is not found.

---

Quick start

# List all sessions, most recent first
$ omnisess list
TOOL       ID              PROJECT                      MESSAGES  LAST ACTIVE
claude     5c3f2742        ~/prj/myapp                  42        2h ago
cursor     a1b2c3d4        ~/prj/api                    18        5h ago

# Sessions from a specific calendar day (local time)
$ omnisess list --date 2026-04-22

# Search across all sources
$ omnisess search "database migration"
claude:5c3f2742  ~/prj/myapp  "...ran the database migration script..."

# Show currently active sessions
$ omnisess active
claude:5c3f2742  ~/prj/myapp  (process alive, modified 47s ago)

---

Supported sources

Source	Status
Claude Code	Full
Cursor	Full
Codex	Full
GitHub Copilot CLI	Full
Gemini	Stub

---

Commands

Command	Description
omnisess list	List all sessions across all sources
omnisess search <query>	Full-text search across sessions
omnisess active	Show sessions detected as currently running
omnisess show <tool:id>	Show full detail for a single session
omnisess ps	Live Claude process tree with ancestor lineage (macOS)
omnisess tui	Interactive terminal UI for browsing sessions
omnisess version	Print the installed omnisess version
omnisess skills audit	Classify skills by usage (Keep/Borderline/Archive); see docs/skills-audit.md

Global flags

These flags are accepted by every subcommand:

Flag	Description
--json	Output as JSON instead of a table
--tool <name>	Filter by source (claude, cursor, codex, copilot, gemini)
--since <duration>	Only sessions updated within duration (Go duration, plus Nd for days, Nw for weeks)
--date YYYY-MM-DD	Only sessions updated on this calendar day (local time). Combines with --since by intersection
--limit N	Max results (0 = unlimited)
--project <substring>	Filter by project path substring
--exclude-project <substring>	Exclude project path substring (repeatable; also via OMNISESS_EXCLUDE_PROJECTS env var, comma-separated)

---

Releases

Versioned releases are published to the GitHub releases page.

Install a specific version:

go install github.com/psacc/omnisess@v0.4.1

Install the latest tagged release:

go install github.com/psacc/omnisess@latest

Verify the installed version:

omnisess --version

Binaries installed via go install github.com/psacc/omnisess@vX.Y.Z embed the module version automatically. Binaries built locally with go build report (devel).

See docs/process/release.md for the release process.

---

Contributing

1. Fork the repository and create a feature branch (git checkout -b feat/my-change).
2. Run make setup (one-time) — installs git hooks and golangci-lint at the pinned version. Or run make install-lint to install/upgrade the linter alone.
3. Make your changes and run make check (fmt + vet + lint + test) — must pass clean.
4. Open a pull request against main.

All source packages under internal/source/<name>/ must remain isolated (no cross-imports). Pure Go only — no CGO.

---

License

MIT — see LICENSE.