Skip to content

feat(commands): /link and /attach structured stash #138

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
BunsDev wants to merge 1 commit into from
Closed

feat(commands): /link and /attach structured stash #138

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 46 additions & 1 deletion docs/commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This document is the reference for the visible slash commands available in Coven
3. [Model & Provider](#model--provider) — `/model`, `/providers`, `/connect`, `/thinking`, `/effort`
4. [Configuration & Settings](#configuration--settings) — `/config`, `/permissions`, `/hooks`, `/mcp`
5. [Code & Git](#code--git) — `/commit`, `/diff`, `/review`, `/init`, `/search`
6. [Search & Files](#search--files)
6. [Search & Files](#search--files) — `/link`, `/attach`
7. [Memory & Context](#memory--context) — `/memory`, `/usage`, `/status`
8. [Agents & Tasks](#agents--tasks) — `/familiar`, `/tasks`, `/coven goal`
9. [Planning & Review](#planning--review) — `/plan`, `ultraplan` (CLI)
Expand Down Expand Up @@ -533,6 +533,51 @@ Analyze context window usage. Shows a breakdown of tokens consumed by system pro

---

### /link

Save and manage links in the structured stash. Links are stored in `~/.coven-code/stash.sqlite` with title, note, tags, project, and session metadata.

```
/link <url> [--title ...] [--note ...] [--tags a,b] — save a link
/link add <url> [flags] — same as above
/link list [--tag <tag>] [--project] — list saved links
/link search <term> — search links
/link remove <id> — delete a link
```

`/link list` shows each entry's short id, save date, title, URL, and tags. `--project` limits the listing to links saved from the current repository. The stash is a personal local store and is disabled in [hosted review mode](configuration#hosted-review-mode).

```
/link https://docs.rs/tokio --title Tokio docs --tags rust,async
/link list --tag rust
/link remove 1a2b3c4d
```

---

### /attach

Save and manage file attachments in the structured stash. Files are copied into `~/.coven-code/attachments/<id>/`, so the stored copy survives even if the original file moves or is deleted. Metadata lives in `~/.coven-code/stash.sqlite` alongside saved links.

```
/attach <path> [--title ...] [--note ...] [--tags a,b] — save a file
/attach add <path> [flags] — same as above
/attach list [--tag <tag>] [--project] — list attachments
/attach search <term> — search attachments
/attach show <id> — show stored/original paths
/attach remove <id> — delete an attachment and its stored copy
```

Relative paths resolve against the current working directory; `~` expands to the home directory. Like `/link`, the stash is disabled in hosted review mode.

```
/attach ./design/spec.pdf --title API spec --tags design
/attach list --tag design
/attach show 1a2b3c4d
```

---

## Memory & Context

### /memory
Expand Down
Loading