Component Overview
Install
npx claudepluginhub psacc/omnisessComponent Details
Commands (6)
Show currently active AI coding sessions — those whose process is alive and session file was modified within the last 2 minutes.
List AI coding sessions across all sources (Claude Code, Cursor, Codex, Gemini). Supports filtering by tool, date, and limit.
Show active Claude Code sessions as a process tree, grouped by shared ancestor chain up to launchd. macOS-only.
Produce a structured markdown briefing of AI coding sessions for a given time window (today / yesterday / Nd). Groups sessions by project and summarizes intent, outcome, and status for each.
Full-text search across all AI coding sessions (Claude Code, Cursor, Codex, Gemini). Pass your search query as the argument.
Show full detail for a single AI coding session. Provide the session ID in <tool>:<id> format (e.g., claude:5c3f2742).
Skills (6)
Show the full detail of a single AI coding session by its ID. Session IDs are in the format <tool>:<id> (e.g., claude:5c3f2742, cursor:a1b2c3d4). Use this skill when asked to show a specific session, inspect a session, read a session, or view the messages in a session. Trigger phrases: "show session", "open session", "inspect session", "read session", "show me claude:5c3f2742", "view session details", "what happened in session".
Show currently active AI coding sessions (Claude Code, Cursor, Codex, Gemini). A session is active if the underlying process is alive and the session file was modified within the last 2 minutes. Use this skill when asked about active sessions, running sessions, what is currently open, or which AI tools are in use right now. Trigger phrases: "active sessions", "running sessions", "what's open", "current sessions", "is claude running", "what sessions are active", "show active".
List AI coding sessions across all sources (Claude Code, Cursor, Codex, Gemini). Use this skill when asked to list sessions, show recent sessions, filter sessions by tool, or get an overview of coding activity. Trigger phrases: "list sessions", "show sessions", "recent sessions", "sessions from cursor", "sessions today", "how many sessions", "show me my sessions".
Show live Claude Code sessions as a process tree, grouped by shared ancestor chain up to launchd. Covers both CLI sessions and Claude Desktop agent mode. Use this skill when asked about the process tree, ancestor lineage, which terminal or tmux window a Claude session is running in, or what's currently running. Trigger phrases: "process tree", "what's running", "lineage", "ancestor chain", "which terminal is my claude in", "tmux tree", "claude process tree", "session lineage". macOS-only: on other platforms the command prints "unsupported" and exits 0.
Produce a structured markdown briefing of AI coding sessions for a given time window. Groups sessions by project and summarizes each group with intent, outcome, and status. Use this skill when asked to recap recent coding work, summarize today's sessions, show what was worked on, or produce a daily/weekly session summary. Trigger phrases: "recap", "what did I work on", "daily summary", "session summary", "summarize my sessions", "what sessions did I have today", "coding recap". This is the sessions-only public version — no Slack, Jira, Granola, or Todoist integration.
Full-text search across all AI coding sessions (Claude Code, Cursor, Codex, Gemini). Use this skill when asked to search sessions, find a conversation about a topic, look up what was discussed in past sessions, or find sessions mentioning specific code or concepts. Trigger phrases: "search sessions", "find sessions about", "look up in sessions", "what did I discuss about", "find conversation about", "search my history".
README
omnisess
Aggregate AI coding sessions across Claude Code, Cursor, Codex, 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—omnisessis the plugin name,psaccis the marketplace source added in the first command.
Usage
Once installed, six 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 --since 24h |
/omnisess:ps | Live Claude process tree with ancestor lineage (macOS) | /omnisess:ps |
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
# 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 | Stub |
| 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 |
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
- Fork the repository and create a feature branch (
git checkout -b feat/my-change). - Make your changes and run
make check(fmt + vet + lint + test) — must pass clean. - 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.
Similar Plugins
planning-with-files
Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Works with Claude Code, Kiro, Clawd CLI, Gemini CLI, Cursor, Continue, Hermes, and 17+ AI coding assistants. Now with Arabic, German, Spanish, and Chinese (Simplified & Traditional) support.