Skip to content

Commit 0e4acad

Browse files
committed
docs: fix audit issues - versions, completion cmd, recall flags
- Update installation examples from v0.1.2 to v0.2.0 - Document `ctx completion` command with shell-specific examples - Add `--all-projects` flag to recall list/show/export docs Signed-off-by: Jose Alekhinne <alekhinejose@gmail.com>
1 parent 9223c96 commit 0e4acad

2 files changed

Lines changed: 74 additions & 28 deletions

File tree

docs/cli-reference.md

Lines changed: 59 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -348,6 +348,49 @@ ctx compact --no-auto-save
348348

349349
---
350350

351+
### `ctx completion`
352+
353+
Generate shell autocompletion scripts.
354+
355+
```bash
356+
ctx completion <shell>
357+
```
358+
359+
#### Subcommands
360+
361+
| Shell | Command |
362+
|--------------|--------------------------|
363+
| `bash` | `ctx completion bash` |
364+
| `zsh` | `ctx completion zsh` |
365+
| `fish` | `ctx completion fish` |
366+
| `powershell` | `ctx completion powershell` |
367+
368+
#### Installation
369+
370+
=== "Bash"
371+
372+
```bash
373+
# Add to ~/.bashrc
374+
source <(ctx completion bash)
375+
```
376+
377+
=== "Zsh"
378+
379+
```bash
380+
# Add to ~/.zshrc
381+
source <(ctx completion zsh)
382+
```
383+
384+
=== "Fish"
385+
386+
```bash
387+
ctx completion fish | source
388+
# Or save to completions directory
389+
ctx completion fish > ~/.config/fish/completions/ctx.fish
390+
```
391+
392+
---
393+
351394
### `ctx tasks`
352395

353396
Manage task archival and snapshots.
@@ -485,11 +528,12 @@ ctx recall list [flags]
485528

486529
**Flags**:
487530

488-
| Flag | Short | Description |
489-
|-------------|-------|-------------------------------------------|
490-
| `--limit` | `-n` | Maximum sessions to display (default: 20) |
491-
| `--project` | `-p` | Filter by project name |
492-
| `--tool` | `-t` | Filter by tool (e.g., `claude-code`) |
531+
| Flag | Short | Description |
532+
|------------------|-------|-------------------------------------------|
533+
| `--limit` | `-n` | Maximum sessions to display (default: 20) |
534+
| `--project` | `-p` | Filter by project name |
535+
| `--tool` | `-t` | Filter by tool (e.g., `claude-code`) |
536+
| `--all-projects` | | Include sessions from all projects |
493537

494538
Sessions are sorted by date (newest first) and display slug, project,
495539
start time, duration, turn count, and token usage.
@@ -513,10 +557,11 @@ ctx recall show [session-id] [flags]
513557

514558
**Flags**:
515559

516-
| Flag | Description |
517-
|------------|------------------------------------|
518-
| `--latest` | Show the most recent session |
519-
| `--full` | Show full message content |
560+
| Flag | Description |
561+
|------------------|------------------------------------|
562+
| `--latest` | Show the most recent session |
563+
| `--full` | Show full message content |
564+
| `--all-projects` | Search across all projects |
520565

521566
The session ID can be a full UUID, partial match, or session slug name.
522567

@@ -539,10 +584,11 @@ ctx recall export [session-id] [flags]
539584

540585
**Flags**:
541586

542-
| Flag | Description |
543-
|-----------|------------------------------------------|
544-
| `--all` | Export all sessions |
545-
| `--force` | Overwrite existing files |
587+
| Flag | Description |
588+
|------------------|------------------------------------------|
589+
| `--all` | Export all sessions |
590+
| `--force` | Overwrite existing files |
591+
| `--all-projects` | Export from all projects |
546592

547593
Exported files include session metadata, tool usage summary, and the full
548594
conversation. Existing files are skipped by default to preserve your edits.

docs/index.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -67,49 +67,49 @@ Download pre-built binaries from the
6767
=== "Linux (x86_64)"
6868

6969
```bash
70-
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.2/ctx-0.1.2-linux-amd64
71-
chmod +x ctx-0.1.2-linux-amd64
72-
sudo mv ctx-0.1.2-linux-amd64 /usr/local/bin/ctx
70+
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.2.0/ctx-0.2.0-linux-amd64
71+
chmod +x ctx-0.2.0-linux-amd64
72+
sudo mv ctx-0.2.0-linux-amd64 /usr/local/bin/ctx
7373
```
7474

7575
=== "Linux (ARM64)"
7676

7777
```bash
78-
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.2/ctx-0.1.2-linux-arm64
79-
chmod +x ctx-0.1.2-linux-arm64
80-
sudo mv ctx-0.1.2-linux-arm64 /usr/local/bin/ctx
78+
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.2.0/ctx-0.2.0-linux-arm64
79+
chmod +x ctx-0.2.0-linux-arm64
80+
sudo mv ctx-0.2.0-linux-arm64 /usr/local/bin/ctx
8181
```
8282

8383
=== "macOS (Apple Silicon)"
8484

8585
```bash
86-
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.2/ctx-0.1.2-darwin-arm64
87-
chmod +x ctx-0.1.2-darwin-arm64
88-
sudo mv ctx-0.1.2-darwin-arm64 /usr/local/bin/ctx
86+
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.2.0/ctx-0.2.0-darwin-arm64
87+
chmod +x ctx-0.2.0-darwin-arm64
88+
sudo mv ctx-0.2.0-darwin-arm64 /usr/local/bin/ctx
8989
```
9090

9191
=== "macOS (Intel)"
9292

9393
```bash
94-
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.2/ctx-0.1.2-darwin-amd64
95-
chmod +x ctx-0.1.2-darwin-amd64
96-
sudo mv ctx-0.1.2-darwin-amd64 /usr/local/bin/ctx
94+
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.2.0/ctx-0.2.0-darwin-amd64
95+
chmod +x ctx-0.2.0-darwin-amd64
96+
sudo mv ctx-0.2.0-darwin-amd64 /usr/local/bin/ctx
9797
```
9898

9999
=== "Windows"
100100

101-
Download `ctx-0.1.2-windows-amd64.exe` from the releases page and add it to your `PATH`.
101+
Download `ctx-0.2.0-windows-amd64.exe` from the releases page and add it to your `PATH`.
102102

103103
### Verifying Checksums
104104

105105
Each binary has a corresponding `.sha256` checksum file. To verify your download:
106106

107107
```bash
108108
# Download the checksum file
109-
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.2/ctx-0.1.2-linux-amd64.sha256
109+
curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.2.0/ctx-0.2.0-linux-amd64.sha256
110110

111111
# Verify the binary
112-
sha256sum -c ctx-0.1.2-linux-amd64.sha256
112+
sha256sum -c ctx-0.2.0-linux-amd64.sha256
113113
```
114114

115115
On macOS, use `shasum -a 256 -c` instead of `sha256sum -c`.

0 commit comments

Comments
 (0)