Skip to content

phpgao/roost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

roost

Manage AI coding sessions from Claude, Gemini, Codex, Copilot, and OpenCode in one TUI.

中文文档

Install

Homebrew (macOS / Linux)

brew install phpgao/roost/roost

Or tap first, then install:

brew tap phpgao/roost
brew install roost

Go install

go install github.com/phpgao/roost@latest

Build from source

git clone https://github.com/phpgao/roost
cd roost
go install .

Usage

roost                  # interactive TUI
roost --list           # list all projects and sessions
roost --list --json    # JSON output (for scripting)
roost --resume <sid>   # resume a session
roost --delete <sid>   # delete a session

Screenshots

Project list — all your projects across platforms in one view

Project list

Session list — sessions inside a project, with model and message count

Session list

Keybindings

Key Action
↑/k ↓/j Move up / down
g / G First / last item
Enter Enter project / Resume session
n New session (select agent)
Esc Back / Exit selection / Double-tap to quit
/ Search
d Delete current item
Space Batch select / Toggle
D Batch delete selected
x Delete entire project (in session view)
Tab Cycle platform filter (All → CL → GE → CX → CP → OC)
r Refresh
? Full keybinding list
q Quit

Configuration

~/.roost/roost.yaml (auto-created on first launch)

# resume mode:
#   replace - process replacement, returns to shell after agent exits (default)
#   suspend - subprocess mode, returns to roost TUI after agent exits
resume_mode: replace

platforms:
  claude:
    bin: claude
    data_dir: .claude
    # args: [--dangerously-skip-permissions]
  gemini:
    bin: gemini
    data_dir: .gemini
    # args: [-y]
  codex:
    bin: codex
    data_dir: .codex
    # args: [--full-auto]
  copilot:
    bin: copilot
    data_dir: .copilot
    # args: []
  opencode:
    bin: opencode
    # args: []

Supported Platforms

Platform Data Directory Resume Command
Claude ~/.claude/ claude --resume <sid>
Gemini ~/.gemini/ gemini --resume <sid>
Codex ~/.codex/ codex resume <sid>
Copilot ~/.copilot/ copilot --resume=<sid>
OpenCode SQLite DB (via opencode db path) opencode -s <sid>

Tech Stack

License

MIT

About

Interactive TUI for managing AI coding sessions across CodeBuddy, Claude, Gemini and Codex

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors