58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
# Hermes Plugin: Session List (/sl)
|
|
|
|
Custom slash command for [Hermes Agent](https://github.com/NousResearch/hermes-agent) that replaces the built-in `/sessions` with configurable columns.
|
|
|
|
## Features
|
|
|
|
- Configurable columns (field, width, label) via `~/.hermes/session_list_config.yaml`
|
|
- Token stats: cache hit, cache miss, output tokens
|
|
- 1-based row numbers for `/resume <#>`
|
|
- Survives `hermes update` (lives in `~/.hermes/plugins/`)
|
|
|
|
## Install
|
|
|
|
From **GitHub**:
|
|
```bash
|
|
hermes plugins install https://github.com/alhan/hermes-plugin-session-list.git --enable
|
|
```
|
|
|
|
From **Gitea** (self-hosted):
|
|
```bash
|
|
hermes plugins install https://git.softmediadesign.com/git_alhan/hermes-plugin-session-list.git --enable
|
|
```
|
|
|
|
Then `/new` (or restart Hermes) to reload.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/sl # last 20 sessions
|
|
/sl 5 # last 5 sessions
|
|
```
|
|
|
|
## Column Config
|
|
|
|
Copy `session_list_config.example.yaml` to `~/.hermes/session_list_config.yaml` and customize:
|
|
|
|
```yaml
|
|
columns:
|
|
- {field: "#", width: 3, label: "#"}
|
|
- {field: title, width: 42, label: Title}
|
|
- {field: message_count, width: 5, label: Msgs}
|
|
- {field: cache_read_tokens, width: 7, label: hit}
|
|
- {field: input_tokens, width: 7, label: miss}
|
|
- {field: output_tokens, width: 7, label: out}
|
|
- {field: model, width: 10, label: Model}
|
|
- {field: source, width: 4, label: Src}
|
|
- {field: last_active, width: 11, label: Active}
|
|
```
|
|
|
|
Available fields: `#`, `id`, `source`, `model`, `title`, `started_at`, `ended_at`, `message_count`, `preview`, `last_active`, `input_tokens`, `output_tokens`, `total_tokens`, `net_input`, `net_total`, `cache_read_tokens`, `cache_write_tokens`, `reasoning_tokens`
|
|
|
|
Set `width: 0` on the **last** column for free-form (no truncation).
|
|
|
|
## Repos
|
|
|
|
- GitHub: https://github.com/alhan/hermes-plugin-session-list
|
|
- Gitea: https://git.softmediadesign.com/git_alhan/hermes-plugin-session-list
|