Skip to main content

​
Overview

The projects command lets you browse and manage all projects oobo has discovered. By default it launches an interactive TUI. With --agent, it returns structured JSON. 
oobo projects              # Interactive TUI
oobo projects --agent      # JSON output

​
Subcommands

​
projects list

List all tracked projects. 
oobo projects list
oobo projects list --agent
​
--agent
boolean
default:"false"
Output as JSON.
oobo projects list

​
projects show

Show details for a specific project. 
oobo projects show <name>
oobo projects show myapp
oobo projects show myapp --agent
​
name
string
required
Project name, slug (ID), or absolute path.
​
--agent
boolean
default:"false"
Output as JSON.
oobo projects show myapp

​
projects forget

Remove a project from tracking. This deletes the project from oobo’s database and removes its local cache, but does not delete the project directory or git repository. 
oobo projects forget <name>
oobo projects forget myapp
​
name
string
required
Project name, slug (ID), or absolute path.
This removes all session data and analytics for the project. The operation cannot be undone (unless you run oobo scan again).

​
Default Behavior

When you run oobo projects with no subcommand, it defaults to projects list with an interactive TUI: 
oobo projects              # same as: oobo projects list
oobo projects --agent      # same as: oobo projects list --agent

​
Interactive TUI

The TUI shows:
  • Project name
  • Path - Absolute path to project directory
  • Tools - AI tools detected (Cursor, Claude, etc.)
  • Sessions - Total session count
  • Tokens - Total input + output tokens
  • Duration - Total session time
Navigation:
  • Arrow keys - Move between projects
  • Enter - View project details and sessions
  • Esc - Exit

​
Output Fields

​
Project Object

FieldTypeDescription
idstringProject slug (unique identifier)
namestringProject name (directory name)
pathstringAbsolute path to project
git_remotestringGit remote URL (if available)
toolsarrayList of AI tools detected
sessionsnumberTotal session count
input_tokensnumberTotal input tokens
output_tokensnumberTotal output tokens
total_tokensnumberSum of input + output
duration_secsnumberTotal session duration

​
Session Object (in projects show)

FieldTypeDescription
session_idstringFull session UUID
sourcestringTool name
namestringSession title
modestringSession mode
modelstringAI model used
input_tokensnumberInput tokens
output_tokensnumberOutput tokens
duration_secsnumberSession duration
files_touchedarrayFiles modified
tool_callsnumberTool/function calls
created_atnumberUnix timestamp
updated_atnumberUnix timestamp
message_countnumberNumber of messages

​
Use Cases

​
List all projects

oobo projects

​
Get project details

oobo projects show myapp

​
Export project list as JSON

oobo projects --agent > projects.json

​
Find projects by tool

oobo projects --agent | jq '.[] | select(.tools | contains(["cursor"]))'

​
Get top projects by token usage

oobo projects --agent | jq 'sort_by(.total_tokens) | reverse | .[0:5]'

​
Remove old project

oobo projects forget old-project

​
See all sessions for a project

oobo projects show myapp --agent | jq '.sessions'

​
Project Discovery

Projects are discovered during oobo scan. Oobo detects:
  1. Git repositories - Directories with .git
  2. AI tool sessions - Sessions from Cursor, Claude, Gemini, etc.
  3. Tool configuration - Enabled tools in ~/.oobo/config.toml
To add new projects: 
oobo scan                  # Scan all tools
oobo scan --project /path  # Scan specific project

​
Project Identification

You can reference projects by:
  • Name - Directory name (e.g., myapp)
  • Slug (ID) - Unique identifier (e.g., myapp-1234567890)
  • Path - Absolute path (e.g., /Users/dev/myapp)
All three work with projects show and projects forget: 
oobo projects show myapp
oobo projects show myapp-1234567890
oobo projects show /Users/dev/myapp

​
Plain Text Output

When stdout is not a terminal (e.g., piped or redirected), projects list outputs plain text: 
oobo projects | cat
Output: 
PROJECT                      SESSIONS TOOLS            TOKENS  PATH
myapp                              42 Cursor, Claude    209k  /Users/dev/myapp
api-service                        18 Claude            95k  /Users/dev/api

2 project(s)

​
Next Steps

Scan

Learn how to discover new projects

Sessions

View sessions within a project

Build docs developers (and LLMs) love

Get started for freeTalk to us