oc-session 0.1.0

# oc-session

[![CI](https://github.com/Shane0xM/oc-session/actions/workflows/ci.yml/badge.svg)](https://github.com/Shane0xM/oc-session/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/oc-session.svg)](https://crates.io/crates/oc-session)
[![docs.rs](https://docs.rs/oc-session/badge.svg)](https://docs.rs/oc-session)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/rust-1.88%2B-orange.svg)](https://www.rust-lang.org/)
[![OpenCode](https://img.shields.io/badge/OpenCode-session%20browser-purple.svg)](https://opencode.ai/)

Global OpenCode session browser and resume tool.

`oc-session` finds OpenCode SQLite databases across OS-specific data locations, lists root sessions by latest activity, supports keyword search across session metadata and previews, and resumes the selected session from any directory.

## Install

```sh
cargo install oc-session
```

From source:

```sh
cargo install --git https://github.com/Shane0xM/oc-session
```

Install the optional bundled OpenCode agent skill:

```sh
oc-session skill install
```

## Usage

```sh
oc-session                 # interactive picker
oc-session --search project # filtered picker
oc-session search project   # filtered picker
oc-session search api --no-tui
oc-session recent -l 20
oc-session recent --json
oc-session last --print
oc-session resume ses_...
oc-session print ses_...
oc-session copy ses_...
oc-session scan
oc-session scan --include "~/Library/Mobile Documents"
oc-session doctor
oc-session skill install
```

## Search

Default search matches session-focused fields:

```text
session id, title, agent, model, project name, recent message preview
```

Directory and path fields are searched only when the query looks path-like, for example:

```text
/project
~/work
.local/share
path:data-services
```

This keeps short project names from matching every session that merely happened to run under a similarly named directory.

## Key Bindings

```text
Enter       resume selected session
Esc         clear search, or quit when search is empty
Ctrl+C      quit
Ctrl+Y      copy selected resume command
Ctrl+U      clear search
Ctrl+A/E    move search cursor to start/end
Ctrl+W      delete previous word
Arrow keys  move selection or search cursor
Home/End    move search cursor to start/end
Delete      delete character under search cursor
Backspace   delete character before search cursor
```

The default resume command is:

```sh
opencode {directory} --session {session_id}
```

The default command is executed without a shell. Custom `resume_command` values are shell-executed after placeholder values are shell-quoted.

## Config

Optional config path:

```text
~/.config/oc-session/config.toml
```

Example:

```toml
resume_command = 'opencode {directory} --session {session_id}'
limit = 500

[paths]
include = []
exclude = []

[ui]
show_directory = true
show_agent = true
show_model = false
```

## Data Sources

The CLI discovers `opencode*.db` files in known OpenCode data locations, including XDG data directories and common macOS, Linux, and Windows equivalents. Default discovery is intentionally shallow for speed and to avoid expensive cloud-drive walks. Use `oc-session scan --include <PATH>` to search additional directories or direct database paths.

## Agent Skill

This crate includes an optional OpenCode skill for agents working on `oc-session`.

The source skill lives at:

```text
skills/oc-session/SKILL.md
```

Install the bundled skill into your global OpenCode skills:

```sh
oc-session skill install
```

This writes to:

```text
~/.config/opencode/skills/oc-session/SKILL.md
```

Useful skill commands:

```sh
oc-session skill path
oc-session skill print
oc-session skill install --force
```

Restart OpenCode after installing the skill so it can be discovered.