CLI
sazabi threads
Command reference for sazabi threads.
sazabi threads — Manage agent threads. Subcommands: list, get, search, archive, unarchive, fork, visibility, stop, stream, share.
sazabi threads
Manage agent threads
sazabi threads <subcommand>sazabi threads list # List all threads
sazabi threads get <thread-id> # Get thread with messages
sazabi threads search "error" # Search threads
sazabi threads archive <thread-id> # Archive a thread
sazabi threads unarchive <thread-id> # Unarchive a thread
sazabi threads fork <thread-id> -m <message-id> # Fork a thread
sazabi threads visibility <thread-id> private # Set visibility
sazabi threads stop <thread-id> # Stop the active run
sazabi threads stream <thread-id> # Stream live agent events
sazabi threads share create <thread-id> # Create a share linksazabi threads list
List threads from the active project
sazabi threads list [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--limit | string | No | Maximum number of threads to return (default: 20, max: 100) |
--cursor | string | No | Pagination cursor from previous response |
--status | string | No | Filter by status: regular or archived |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi threads list # List all threads
sazabi threads list --limit 50 # List with custom limit
sazabi threads list --status archived # List archived threads
sazabi threads list --cursor xyz # List next pagesazabi threads get
Get thread with messages
sazabi threads get <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi threads get <thread-id> # Get thread with messages
sazabi threads get <thread-id> --json # Output as JSONsazabi threads search
Search threads in the active project
sazabi threads search <query> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--limit | string | No | Maximum number of results (default: 20, max: 100) |
--page | string | No | Page number for pagination (default: 1) |
--status | string | No | Filter by status: regular or archived |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi threads search "error handling" # Search threads
sazabi threads search "bug" --limit 50 # Search with limit
sazabi threads search "authentication" --status regular # Search only regular threadssazabi threads archive
Archive a thread
sazabi threads archive <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi threads archive <thread-id> # Archive a thread
sazabi threads archive <thread-id> --json # Output as JSONsazabi threads unarchive
Unarchive a thread
sazabi threads unarchive <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi threads unarchive <thread-id> # Unarchive a thread
sazabi threads unarchive <thread-id> --json # Output as JSONsazabi threads fork
Fork a thread from a message into a new thread
sazabi threads fork <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--message-id, -m | string | No | Message ID to fork from (copies messages up to it) |
sazabi threads fork <thread-id> --message-id <message-id> # Fork from a message
sazabi threads fork <thread-id> -m <message-id> --json # Output as JSONsazabi threads visibility
Set a thread's visibility (private or organization)
sazabi threads visibility <thread-id> <private|organization> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
sazabi threads visibility <thread-id> private # Restrict to owner
sazabi threads visibility <thread-id> organization # Share with organizationsazabi threads stop
Stop a thread's in-flight run
sazabi threads stop <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
sazabi threads stop <thread-id> # Stop the thread's active run
sazabi threads stop <thread-id> --json # Output the result as JSONsazabi threads stream
Stream a thread's live agent-run events
sazabi threads stream <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--cursor | string | No | Resume from a prior stream cursor after a disconnect |
sazabi threads stream <thread-id> # Follow live thread events
sazabi threads stream <thread-id> --json # Emit NDJSON events for tools
sazabi threads stream <thread-id> --cursor seq:42 # Resume after a disconnectsazabi threads share
Manage public read-only share links for a thread
sazabi threads share <subcommand>sazabi threads share create <thread-id> # Create a share link
sazabi threads share list <thread-id> # List share links
sazabi threads share revoke <thread-id> <share-id> # Revoke a share linksazabi threads share create
Create a public read-only snapshot link for a thread
sazabi threads share create <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
sazabi threads share create <thread-id> # Create a share linksazabi threads share list
List active public share links for a thread
sazabi threads share list <thread-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
sazabi threads share list <thread-id> # List share linkssazabi threads share revoke
Revoke a public share link for a thread
sazabi threads share revoke <thread-id> <share-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
sazabi threads share revoke <thread-id> <share-id> # Revoke a share link