Sazabi
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 link

sazabi threads list

List threads from the active project

sazabi threads list [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--limitstringNoMaximum number of threads to return (default: 20, max: 100)
--cursorstringNoPagination cursor from previous response
--statusstringNoFilter by status: regular or archived
--jsonbooleanNoOutput as JSON
--api-base-urlstringNoOverride 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 page

sazabi threads get

Get thread with messages

sazabi threads get <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--jsonbooleanNoOutput as JSON
--api-base-urlstringNoOverride API base URL
sazabi threads get <thread-id>  # Get thread with messages
sazabi threads get <thread-id> --json  # Output as JSON

Search threads in the active project

sazabi threads search <query> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--limitstringNoMaximum number of results (default: 20, max: 100)
--pagestringNoPage number for pagination (default: 1)
--statusstringNoFilter by status: regular or archived
--jsonbooleanNoOutput as JSON
--api-base-urlstringNoOverride 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 threads

sazabi threads archive

Archive a thread

sazabi threads archive <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--jsonbooleanNoOutput as JSON
--api-base-urlstringNoOverride API base URL
sazabi threads archive <thread-id>  # Archive a thread
sazabi threads archive <thread-id> --json  # Output as JSON

sazabi threads unarchive

Unarchive a thread

sazabi threads unarchive <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--jsonbooleanNoOutput as JSON
--api-base-urlstringNoOverride API base URL
sazabi threads unarchive <thread-id>  # Unarchive a thread
sazabi threads unarchive <thread-id> --json  # Output as JSON

sazabi threads fork

Fork a thread from a message into a new thread

sazabi threads fork <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--message-id, -mstringNoMessage 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 JSON

sazabi threads visibility

Set a thread's visibility (private or organization)

sazabi threads visibility <thread-id> <private|organization> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi threads visibility <thread-id> private  # Restrict to owner
sazabi threads visibility <thread-id> organization  # Share with organization

sazabi threads stop

Stop a thread's in-flight run

sazabi threads stop <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi threads stop <thread-id>  # Stop the thread's active run
sazabi threads stop <thread-id> --json  # Output the result as JSON

sazabi threads stream

Stream a thread's live agent-run events

sazabi threads stream <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--cursorstringNoResume 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 disconnect

sazabi 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 link

sazabi threads share create

Create a public read-only snapshot link for a thread

sazabi threads share create <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi threads share create <thread-id>  # Create a share link

sazabi threads share list

List active public share links for a thread

sazabi threads share list <thread-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi threads share list <thread-id>  # List share links

sazabi threads share revoke

Revoke a public share link for a thread

sazabi threads share revoke <thread-id> <share-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi threads share revoke <thread-id> <share-id>  # Revoke a share link