st for project management tasks like creating cards, managing sprints, searching, and more.
Install the skill
st claude install
~/.claude/skills/superthread-cli/SKILL.md. The skill is bundled inside the st binary. When you run st update, you’ll be prompted to update the skill automatically if it was previously installed. You can also re-run st claude install at any time to get the latest version.
Skill contents
Below is the full skill that gets installed. This is what Claude Code sees when it uses the Superthread CLI on your behalf.Quick Start
st auth login # OAuth2 browser login
st auth status # Verify token + workspace
st boards list -s Engineering # Boards in a space
st cards create -l LIST -b BOARD --title "Task"
st search "auth bug" --types cards
Essential Patterns
--output json / -o json # Structured JSON output (for scripts/agents)
-y / --yes # Skip confirmation prompts
-s SPACE # Scope to a space (name or numeric ID)
-b BOARD # Scope to a board (name or numeric ID)
me # Use as user reference: st projects update ID --owner me
u (e.g. uRaEi3th). Any value not matching these patterns is resolved as a name via API lookup.
All --content flags accept GitHub Flavored Markdown. --description and --desc are accepted as aliases for --content everywhere. The server converts it to HTML before storage. Use standard markdown: headings, bold, lists, task lists (- [ ]), code blocks, blockquotes, etc. Always use multi-line strings for content with structure — never use literal \n escape sequences.
Important: Only set optional fields (priority, estimate, due date, tags) when the user explicitly asks or clearly implies a value. Do not assume defaults for these fields.
Common Workflows
View and manage cards
st cards list -b BOARD # List cards on a board
st cards list --sprint current -s SPACE # List cards in active sprint
st cards list --assignee me # List my active cards (excludes done/cancelled)
st cards list --assignee me --status all # List all my cards including done/cancelled
st cards list --assignee me --status done # List only my completed cards
st cards list --assignee me --tag bug # Filter by tag
st cards list --assignee me -t bug,feature # Filter by multiple tags
st cards list --assignee me --sprint current -s SPACE # My cards in current sprint
st cards list --project "Q1 Roadmap" # Cards in a specific project/epic
st cards get CARD_ID
st cards create --title "Fix login bug" -l LIST -b BOARD
st cards create --title "Sprint task" --sprint current -s Engineering --assignee me # Create in active sprint
st cards create --title "Sprint task" --sprint 90 -s Engineering # Create in specific sprint
st cards create --title "Subtask" -l LIST --project "Q1 Roadmap" # Create in a project (epic)
st cards create --title "Subtask" -l LIST --parent PARENT_CARD_ID # Create with a parent card
st cards create --title "Parent" -l LIST --child CHILD_ID --child CHILD_ID2 # Create with child cards
st cards update CARD_ID --title "New title" --priority 2 --due-date 2026-03-27
st cards update CARD_ID --content "## New description\n\nReplaces existing content."
st cards update CARD_ID --project "Q1 Roadmap" # Add card to a project (epic)
st cards update CARD_ID --project none # Remove card from project
st cards update CARD_ID --parent PARENT_CARD_ID # Set parent card
st cards update CARD_ID --parent none # Remove from parent card
st cards update CARD_ID --child CHILD_CARD_ID # Add a child card
st cards update CARD_ID --child none # Clear all children
st cards update CARD_ID --assignee alice # Add Alice (idempotent if already assigned)
st cards update CARD_ID --assignee none # Clear all assignees
st cards update CARD_ID --tag bug # Add a tag
st cards update CARD_ID --tag none # Clear all tags
st cards list --has-blockers # Cards that are blocked
st cards list --assignee me --has-blocking # My cards that are blocking others
st cards list --relationship-types related,duplicates # Cards with related or duplicate relationships
st cards archive CARD_ID
st cards duplicate CARD_ID
st cards delete CARD_ID # Prompts for confirmation
st cards delete CARD_ID -y # Skip confirmation
Browse structure
st spaces list
st spaces get Engineering # By name
st boards list -s Engineering # Boards in a space
st sprints list -s Engineering
st users list
st users me
Agents
st agents list # what exists
st agents get "Release Notes Writer" # settings + prompt page ID
st pages get PAGE_ID # read its instructions
st agents create --name "Triage Bot" --prompt-file bot.md --model claude_sonnet_5
st agents triggers list "Triage Bot" # what makes it run
st agents access "Triage Bot" # what it can reach
Search
st search "auth bug"
st search "auth bug" --types cards,pages -s Engineering
st search "auth bug" --limit 50 --archived # Include archived
Tags
st cards tags list -s SPACE
st cards tags add CARD_ID TAG... # TAG: name or ID
st cards tags remove CARD_ID TAG
Checklists
st checklists list -c CARD_ID # List checklists on a card
st checklists create -c CARD_ID --title "QA" # Create checklist
st checklists add-item CL_ID -c CARD_ID --title "Step 1"
st checklists check ITEM_ID -c CARD_ID --checklist CL_ID
st checklists uncheck ITEM_ID -c CARD_ID --checklist CL_ID
Comments
st comments list -c CARD_ID
st comments list --page PAGE_ID
st comments create --content "**Important:** check the logs" -c CARD_ID
st comments create --content "Note" --page PAGE_ID
st comments reply COMMENT_ID --content "Reply with **markdown**"
st comments react COMMENT_ID --unicode "👍"
st comments delete COMMENT_ID
Project Health
st projects health update PROJECT_ID --status at-risk -m "Blocked on dependency"
st projects health list PROJECT_ID # View health update history
st projects health delete COMMENT_ID # Revert to previous status
st projects health set-period PROJECT_ID --days 14 # Configure staleness period ('none' to disable)
st projects get PROJECT_ID --health # Project details with inline health history
on-track, at-risk, off-track, not-expected
Full Command Reference
Auth
st auth login # Browser OAuth2
st auth status # Show token + workspace info
st auth logout # Remove stored credentials
st whoami # Alias for `auth status`
Spaces
st spaces list
st spaces get SPACE
st spaces create --title "Name"
# Options: --description, --visibility, --icon
st spaces update SPACE --title "New"
# Options: --description, --visibility, --icon
# --visibility: open | view_only | private
# open the whole workspace can see and edit it, guests aside
# view_only the whole workspace can read it; only members whose role is
# not 'viewer' can edit
# private its members only
# Private and view-only spaces depend on the workspace's plan.
# Turning view_only ON demotes nobody — everyone already in the space keeps
# the role and edit rights they had, and must be demoted to viewer one by
# one, which only the space's owner and workspace admins can do. What
# changes is that people added afterwards join as viewer.
# Turning it off promotes the space's viewers to member, except agents.
# --icon: the emoji character itself (🍌), an icon name, or an image URL.
# Like a project's, a space icon cannot be removed once set.
st spaces delete SPACE # Confirms
st spaces add-member SPACE -u USER # User: name, email, or ID
# Members are always added with the 'member' role; a viewer role can only be
# set in the app. Adding to a view-only space joins them as a viewer.
st spaces remove-member SPACE -u USER
Boards
st boards list -s SPACE
# Options: --archived
st boards get BOARD
# Options: --space/-s (required when BOARD is a name; numeric IDs skip the check)
st boards create -s SPACE --title "Name"
# Options: --default-lists, --list (repeatable)
# --list "Title:status" sets the board's whole column layout, left to right.
# Prefer it whenever the user's workflow is known: a column's status type
# cannot be changed once it holds tasks, so generic columns renamed later
# keep the wrong one. The status half may be omitted for common stage
# names (Backlog, Todo, In Progress, Done, Cancelled), which are inferred.
# No space after the colon — with one, the whole value is the title, so
# --list "Deals: closed" is a column called "Deals: closed", not "Deals".
# --default-lists creates standard lists: Backlog, Todo, Doing, Done, Cancelled
# Only for a board with no particular workflow. Mutually exclusive with --list.
st boards create -s SPACE --title "Hiring" \
--list "Applied:backlog" --list "Phone Screen:doing" --list "Hired:done"
st boards create -s SPACE --title "Sprint Board" --default-lists
st boards update BOARD --title "New"
# Options: --color, --space/-s (required when BOARD is a name)
# A board has no writable icon. Nothing in the product renders one, so the
# field was removed rather than accepted and ignored.
st boards delete BOARD # Confirms
# Options: --space/-s (required when BOARD is a name)
st boards duplicate BOARD
# Options: --space/-s (required when BOARD is a name)
st boards create-list -b BOARD --title "Column"
# Options: --color, --status, --space/-s (required when --board is a name)
# --status sets the list status type (backlog, todo, doing, done, canceled)
# Status is auto-inferred from common titles (e.g. "To Do" → committed, "Done" → completed)
st boards create-list -b BOARD --title "QA" --status doing
st boards update-list LIST_ID --title "New"
# Options: --color, --status, --board/-b, --space/-s (required when --board is a name)
# --board/-b lets LIST_ID be a column title instead of an ID
# --status re-types the column, but only while it holds no cards — the API
# refuses it otherwise ("Cannot modify list behavior when there are cards added").
# Nothing is inferred from --title here, unlike create-list.
st boards update-list "QA" -b BOARD --status doing
st boards reorder-lists -b BOARD "Backlog" "Doing" "Done"
# Options: --space/-s (required when --board is a name)
# Name EVERY column on the board, in the order they should read left to right.
# A partial order is rejected — a position only means anything relative to the
# whole set. Archived columns are not part of the order; leave them out.
# `st boards get BOARD` lists exactly the ones to name.
validation failed: space_id error if --space is missing on a name-based call. Numeric board IDs short-circuit and don’t need --space.
Cards
st cards list
# Requires one of: --board/-b, --sprint, --assignee/-a, --tag/-t, or a filter flag
# Options: --space/-s (required with --sprint), --status, --tag/-t, --archived
# --assignee/-a supports 'me', user name, email, or ID (comma-separated or repeatable)
# --sprint supports 'current' or sprint name/ID
# --status: comma-separated statuses or 'all'
# Canonical: backlog, committed, started, completed, cancelled
# Aliases: backlog, todo, doing, done, canceled
# (also: in-progress, in_progress, active, finished,
# closed, deployed, production, live, shipped, complete)
# When --assignee is used, defaults to backlog+committed+started (hides done/cancelled)
# --tag/-t: comma-separated tag names or IDs (cards matching any listed tag).
# Works as a scope on its own. A tag NAME resolves against --space; without
# one only a narrow workspace-wide subset is searched, so pass --space (or a
# tag ID) if a name comes back "tag not found".
#
# TWO BACKENDS, chosen by the flags you pass:
# --board/--sprint -> task_list: every ACTIVE card in the container.
# (+ --assignee/--tag/ Assignee, tag and status apply to that listing.
# --status)
# any filter flag below -> find_tasks: --board/--sprint become filters,
# results paginate (25/page unless --limit).
# Filters now compose with --board/--sprint (they used to be rejected).
# --assignee/--tag/--status work as a scope on their own without
# switching a container listing to the paginated backend.
#
# --archived returns archived cards INSTEAD of active ones and always uses
# find_tasks (the container endpoint ignores the sprint scope for archived
# cards and returns nothing useful). No path mixes archived with active, and
# --archived cannot be combined with --sprint.
#
# Reference filters:
# --list/-l ID[,ID...] lists/columns (IDs only — list names aren't resolved)
# --id ID[,ID...] bulk-fetch specific cards by ID
# --parent ID[,ID...] subtasks of these parent cards
# --creator REF[,REF...] filter by creator (name, email, ID, or 'me')
# --project REF[,REF...] project/epic names or IDs (alias: --epic)
# --external-link TYPE github_pull_request | generic
# Content / metadata filters:
# --content TEXT substring match across card title + description
# --title TEXT substring match against title only
# --priority P[,P...] none/low/medium/high/urgent, p0..p4, or 0..4
# --estimate N[,N...] estimate values 0 (unset) .. 5
# Date filters — ISO-8601 ('2026-04-01'), date math ('now-7d', 'now+1w/d'),
# or an alias (today, yesterday, start_of_week, start_of_month, ...):
# --due-before / --due-after
# --start-before / --start-after
# --completed-before / --completed-after
# --created-before / --created-after
# --updated-before / --updated-after (staleness: --updated-before now-30d)
# Presence filters (tristate — unset = no filter, =false to invert):
# --has-due-date, --has-start-date, --has-completed-date, --has-priority,
# --has-estimate, --has-tags, --has-assignees, --has-status,
# --has-parent-card (= --is-child), --is-child, --is-parent,
# --created-from-form
# Relationship filters:
# --has-blockers cards that ARE blocked. Use =false to invert.
# --has-blocking cards that ARE blocking others. Use =false to invert.
# --has-relationship cards with ANY relationship. Use =false to invert.
# --relationship-types OR list: blocks, blocked_by, related, duplicates.
# --exclude-relationship-types same values, subtracted instead.
# Exclude mirrors — each subtracts from the include result:
# --exclude-board, --exclude-list, --exclude-space, --exclude-project,
# --exclude-assignee, --exclude-creator, --exclude-tag, --exclude-id,
# --exclude-parent, --exclude-external-link, --exclude-priority,
# --exclude-estimate, --exclude-title, --exclude-content, --exclude-status
# Sort / paginate:
# --sort-by FIELD due_date | estimate | priority | status | time_created | time_updated
# --sort-desc sort descending (the default); --sort-desc=false for ascending
# --limit N / --cursor C page size and cursor (a value routes through
# find_tasks; --limit 0 means "no limit", which only
# a container listing can honor — find_tasks always
# paginates at its 25/page default)
#
# Rejected combinations (the wire semantics would mislead):
# --has-blockers=true + --has-blocking=true (wire ORs them — use
# --relationship-types=blocked_by,blocks if the OR is what you want)
# --relationship-types with --has-blockers=true / --has-blocking=true
# --exclude-relationship-types with --has-blockers=false / --has-blocking=false
# --status with --exclude-status
# For free-text search across resource kinds, use `st search` instead.
st cards get CARD_ID
st cards create --title "Task" -l LIST -b BOARD
# Options: --content, --priority (0-4), --estimate, --due-date (YYYY-MM-DD), --start-date (YYYY-MM-DD), --sprint, --space/-s, --assignee/-a, --project/--epic, --parent, --child, --tag/-t
# When --sprint is set, --list is optional (defaults to sprint's Todo list)
# --space/-s always required with --sprint
# --project/--epic: project name or ID to add the card to
# --parent: parent card ID
# --child: child card ID (repeatable; clearing children after create is done via `cards update --child none`)
st cards update CARD_ID
# Options: --title, --content, --list/-l, --board/-b, --sprint, --space/-s, --assignee/-a, --priority, --estimate, --due-date (YYYY-MM-DD), --start-date (YYYY-MM-DD), --project/--epic, --parent, --child, --tag/-t
# --list/-l: list name or ID; --sprint/-s not needed when moving within the card's current sprint/board
# --content replaces existing content entirely
# --sprint: name, ID, or 'current'; --space/-s always required with --sprint
# --board: name or ID. For names: scoped by --space if given, else lazy-fetches the card's current space.
# --project/--epic: project name or ID; use 'none' to remove from project
# --parent: parent card ID; use 'none' to remove from parent
# --assignee/-a: comma-separated. Adds to existing assignees (idempotent on re-add); use 'none' to clear all.
# --tag/-t: comma-separated. Adds to existing tags; use 'none' to clear all.
# --child: comma-separated child card IDs. Adds to existing children; use 'none' to clear all.
st cards delete CARD_ID # Confirms
st cards archive CARD_ID
st cards duplicate CARD_ID
Cards — Tags
st cards tags list
# Options: --space/-s
st cards tags add CARD_ID TAG [TAG...] # TAG: name or ID
st cards tags remove CARD_ID TAG
Cards — Related
st cards related add CARD_ID RELATED_CARD_ID # --type/-t: related (default), blocks, blocked_by, duplicates
st cards related remove CARD_ID RELATED_CARD_ID
Checklists
st checklists list -c CARD_ID # List checklists on a card
st checklists get CHECKLIST_ID -c CARD_ID # Get checklist with items
st checklists create -c CARD_ID --title "QA Steps"
# Options: --content
st checklists update CHECKLIST_ID -c CARD_ID
# Options: --title, --content
st checklists delete CHECKLIST_ID -c CARD_ID # Confirms
st checklists add-item CHECKLIST_ID -c CARD_ID --title "Step 1"
# Options: --content, --checked
st checklists update-item ITEM_ID -c CARD_ID --checklist CHECKLIST_ID
# Options: --title, --content, --checked
st checklists delete-item ITEM_ID -c CARD_ID --checklist CHECKLIST_ID # Confirms
st checklists check ITEM_ID -c CARD_ID --checklist CHECKLIST_ID
st checklists uncheck ITEM_ID -c CARD_ID --checklist CHECKLIST_ID
Projects (Epics)
st projects list
st projects get PROJECT_ID
# Options: --health (include health update history)
st projects create --title "Q1 Roadmap"
# Options: --list/-l (name or ID; defaults to first project list), --content, --owner, --assignee/-a, --priority, --due-date (YYYY-MM-DD), --icon
# Projects live on a dedicated roadmap board. --list refers to columns on that board (e.g. "Backlog", "Planned").
st projects create --title "Sprint goal" -l "In progress" # Create in a specific project list by name
st projects update PROJECT_ID
# Options: --title, --content, --list/-l (name or ID), --owner, --assignee/-a, --priority, --archived, --due-date (YYYY-MM-DD or 'none'), --icon
# --content replaces existing content entirely
# --assignee/-a: comma-separated. Adds to existing assignees (idempotent on re-add); use 'none' to clear all.
# --due-date: 'none' removes the existing due date. A malformed date is still refused.
# --icon: the emoji character itself (🍌), an icon name, or an image URL.
# Unlike a page's, a project icon cannot be removed once set.
st projects delete PROJECT_ID # Confirms
st projects archive PROJECT_ID
st projects related add PROJECT_ID RELATED_ID # --type/-t: related (default), blocks, blocked_by, duplicates
st projects related remove PROJECT_ID RELATED_ID
st projects tags list
st projects tags add PROJECT_ID TAG [TAG...] # TAG: name or ID
st projects tags remove PROJECT_ID TAG
st projects health update PROJECT_ID --status STATUS -m "Message"
# --status: on-track, at-risk, off-track, not-expected
# -m/--message: required explanation for the status change (markdown)
st projects health list PROJECT_ID # List health update history
st projects health delete COMMENT_ID # Delete a health update (reverts status); confirms
st projects health set-period PROJECT_ID --days N
# Days between expected check-ins; project is marked stale if no update within this window
# Use 'none' to disable staleness tracking
st projects get includes health status info. Use --health to also show the health update history inline.
st projects list includes a HEALTH column showing each project’s current health status.
Pages
st pages list -s SPACE # --space/-s required unless a filter flag is used
# TWO BACKENDS, chosen by the flags you pass:
# --space alone -> page_list: every ACTIVE page in the space.
# any filter flag below -> find_pages: results paginate (25/page unless
# --limit).
#
# --archived returns archived pages INSTEAD of active ones, always through
# find_pages. No path mixes archived with active.
#
# --content TEXT substring match across page title + body
# --creator REF[,REF...] pages created by these users (name, email, ID, 'me')
# --id ID[,ID...] bulk-fetch specific pages by ID
# --created-before / --created-after ISO-8601, date math, or alias
# --updated-before / --updated-after (staleness: --updated-before now-30d)
# --exclude-space, --exclude-creator, --exclude-id, --exclude-content
# --sort-by FIELD time_created | time_updated
# --sort-desc sort descending (the default); --sort-desc=false for ascending
# --limit N / --cursor C paginate the views result (a value routes through
# find_pages; --limit 0 means "no limit", which only
# a container listing can honor)
st pages get PAGE_ID
st pages create -s SPACE
# Options: --title, --content, --parent-page, --icon
st pages update PAGE_ID
# Options: --title, --content, --parent-page, --space/-s, --icon
# --content replaces existing content entirely
# --parent-page: page ID to nest this page under (reparent); use 'none' to move it to the top level
# --space/-s: move the page to another space (name or ID). Subpages come along.
# Combine with --parent-page to nest it under a page there; naming a parent
# that lives in another space moves the page to that space on its own.
# --icon: the emoji character itself (🍌), an icon name, or an image URL.
# A page is the one resource whose icon can be taken off: --icon "" removes it.
st pages delete PAGE_ID # Confirms
st pages archive PAGE_ID
st pages duplicate PAGE_ID
Notes
st notes list
st notes get NOTE_ID --output json # Read revision, ai_notes, and last_note_template_id first
st notes create --title "Meeting Notes"
st notes delete NOTE_ID # Confirms
st notes templates list --output json # All accessible templates, including exact IDs
st notes templates get TEMPLATE_ID --output json
st notes templates update TEMPLATE_ID --title "Weekly meeting" \
--context "Focus on decisions and actions." --sections-file sections.json
# Options: --title, --context, --sections-file
# Omitted fields stay unchanged. --context "" clears instructions.
# sections.json is the whole ordered [{"title":"Decisions","description":"Capture decisions."}] list.
# A file containing [] clears sections; null is not valid.
st notes templates update TEMPLATE_ID --context ""
st notes templates update TEMPLATE_ID --sections-file empty-sections.json # File contents: []
# 'notes template' is an alias for 'notes templates'. No template create/delete commands.
st notes enhance NOTE_ID --instructions "Shorten this and group actions by owner." \
--expected-revision REVISION
st notes enhance NOTE_ID --instructions "Keep only decisions." \
--enhanced-note ENHANCED_NOTE_ID --expected-revision REVISION
st notes enhance NOTE_ID --template TEMPLATE_ID --instructions "Include owners and deadlines." \
--expected-revision REVISION --operation OPERATION_UUID --output json
# Options: --instructions, --template, --enhanced-note, --expected-revision, --operation
# At least non-empty instructions or a template is required.
# --enhanced-note selects an entry for instruction-only revision; do not combine with --template.
# --operation is a UUID for an identical retry; different input with that ID conflicts.
st notes enhancement NOTE_ID --output json # Latest operation, or idle when none exists
st notes enhancement NOTE_ID --operation OPERATION_UUID --output json
# --operation observes a specific operation rather than the latest one.
--enhanced-note selects a saved entry; otherwise the entry matching last_note_template_id is used. A missing or empty enhanced entry fails. An explicit --template regenerates from original user notes and the transcript, with optional extra instructions. Neither mode changes the original notes, transcript, or saved template.
Read st notes get NOTE_ID --output json before enhancement and use its whole-note revision as --expected-revision. If the revision or operation UUID is omitted, the adapter supplies the current revision or a new UUID. A concurrent edit still prevents the final save. Another operation running on the same note, a stale revision, or an operation UUID reused with different input fails; read the latest note before retrying a conflict.
Status is idle, running, completed, or failed. Running content is an unsaved preview. Only completed with ai_note confirms a durable save. If still running, use st notes enhancement with the returned operation UUID, including after disconnecting. Failures return errors and leave the last saved content intact; never claim preview content was saved. Reuse --operation only for identical retry input, and use a new UUID for a new request.
Only the note owner can start or observe an enhancement. A custom agent’s note read grant allows reading the note, but does not allow editing it or observing enhancement operations.
Comments & Replies
st comments list -c CARD_ID # List comments on a card
st comments list --page PAGE_ID # List comments on a page
# Options: --filter (resolved, open, orphaned)
st comments get COMMENT_ID
st comments create --content "Text" -c CARD_ID
st comments create --content "Text" --page PAGE_ID
st comments edit COMMENT_ID --content "Updated"
st comments delete COMMENT_ID # Confirms
st comments reply COMMENT_ID --content "Reply text"
st comments react COMMENT_ID --unicode "👍"
st comments unreact COMMENT_ID --reaction REACTION_ID
st comments replies list COMMENT_ID
st comments replies edit COMMENT_ID REPLY_ID --content "Updated"
st comments replies delete COMMENT_ID REPLY_ID # Confirms
Sprints
st sprints list -s SPACE # --space/-s required
# Options: --archived
st sprints get SPRINT_ID -s SPACE # --space/-s required
st sprints create -s SPACE
# Options: --title
st sprints update SPRINT_ID -s SPACE # --space/-s required
# Options: --title, --state (planned|active|completed|cancelled), --start-date, --end-date
# --start-date / --end-date: epoch seconds
Sprint Settings
st sprints settings get -s SPACE
st sprints settings update -s SPACE --enabled --length 14 --cooldown 0 --start-day 1
# All flags required. --length: 7-56 days (multiples of 7)
# --cooldown: 0,7,14,21,28 days. --start-day: 0=Sun..6=Sat
Users
st users me # Includes your role in this workspace
st users list
st users update-me
# Options: --first-name, --last-name, --display-name
st users update-member USER --role ROLE # --role required
st users delete-member USER # Confirms
Agents
st agents list # Options: --archived
st agents get AGENT # AGENT: name or ID
# Reports settings, sharing, and the prompt page holding the instructions
st agents create --name "Release Notes"
# Instructions: --prompt TEXT or --prompt-file PATH (max 25600 chars).
# Written to the agent's prompt page by this same call. WITHOUT a prompt the
# agent runs with NO instructions and answers generically.
# Options: --content (blurb; --description is an alias), --model, --effort,
# --role, --general-access, --general-access-can-view-all-runs,
# --active, --mentions-enabled, --icon, --cover-image,
# --web-search, --web-sites, --web-domains
# --model: claude_opus_5_5 | claude_sonnet_5_5 | claude_haiku_5_5
# | claude_opus_5 | claude_sonnet_5 | claude_opus_4_6
# | claude_sonnet_4_6 | claude_haiku_4_5 | gpt_6_astra | gpt_6_1_sol
# | gpt_6_sol | gpt_6_luna | gpt_5_6_sol | gpt_5_6_terra
# | gpt_5_6_luna | gpt_5_4 | gpt_5_4_mini | gpt_5_4_nano
# --effort: default | none | low | medium | high | xhigh | max
# --role: admin | member | guest | guestReader (what the AGENT can access;
# member also reaches every open space, guest/guestReader only the
# spaces the agent is added to; capped at your own role)
# --general-access: none | use | edit (workspace-default access TO the agent)
# --icon: the emoji character itself (🍌) or an image URL
# --web-search: one switch for reaching the web — searching it AND reading a
# page already linked in the chat. Search is billed per search.
# --web-sites: any | allow | block (allow permits ONLY --web-domains;
# block permits everything except them)
# --web-domains: bare domains, comma-separated (example.com, not a URL).
# Subdomains are covered automatically. Needs --web-sites allow or
# block — domains alone are refused, not guessed at.
st agents update AGENT # Same settings flags, plus --name
# Omitted web flags leave web access exactly as it is, and switching
# --web-search=false keeps the domain list for when it goes back on
# Instructions are NOT updated here — edit the prompt page:
# st agents get AGENT -> prompt page ID
# st pages update PAGE_ID --content "..."
# Space access: --role sets the baseline; individual spaces are
# st spaces add-member / st spaces remove-member
st agents archive AGENT # Confirms; disables its triggers
st agents restore AGENT # Triggers stay disabled until enabled
st agents access AGENT # What the AGENT itself can reach
# Role, whether it reaches all open spaces, and its individual space memberships.
# Listed as YOU see it, so real access can be wider. Read-only.
st agents share AGENT -u USER --level use # Who may USE the agent
# --level: use | edit | full_access (required the first time)
# --can-view-all-runs: may read every run, not only their own
# An agent must always keep at least one person with full_access, so lowering
# or removing your own access as the only full-access holder is rejected.
st agents unshare AGENT -u USER # Confirms
Agents — Triggers
st agents triggers list AGENT # Both kinds, with next run times
st agents triggers schedule create AGENT
# Options: --name, --prompt / --prompt-file, --enabled,
# --timezone (IANA, default UTC), --at HH:MM (default 09:00),
# --days (mon,tue,... | 0=Sun..6=Sat | 'weekdays' | 'weekend' | 'daily')
# Setting any of --timezone/--at/--days fills the others from the default;
# omitting all three creates the trigger on UTC weekdays 09:00.
# Triggers are created DISABLED — the command prints the command to enable it.
st agents triggers schedule update AGENT --trigger ID
# Same flags. The recurrence is replaced wholesale, so --timezone/--at/--days
# are all-or-nothing: pass all three to change it, none to leave it alone.
# A partial set is refused rather than resetting what you left out.
# --enabled=false pauses a trigger without deleting it.
st agents triggers schedule delete AGENT --trigger ID # Confirms
st agents triggers event create AGENT --event-type TYPE
# --event-type: comment.added.to.card | comment.added.to.epic
# | comment.added.to.page | card.property.changed
# | card.added.to.container | page.added.to.space
# | board.added.to.space
# Options: --name, --prompt / --prompt-file, --enabled,
# --subject-type (card|page|board|sprint|space|roadmap) + --subject-id,
# --property-key, --property-value-operator
# (is_edited|contains|does_not_contain|is_cleared),
# --property-value ID[=LABEL] (repeatable)
# --subject-type and --subject-id go together. --property-* apply only to
# card.property.changed.
st agents triggers event update AGENT --trigger ID # Same flags
st agents triggers event delete AGENT --trigger ID # Confirms
Search
st search QUERY
# Options: --types (cards,pages,boards,...), --limit N, --space/-s, --archived
Completion & Utility
st completion # Interactive guided setup
st completion install # Detect shell and install completions
st completion generate bash|zsh|fish|powershell # Print script to stdout
st claude install # Install/update this skill at ~/.claude/skills/superthread-cli/SKILL.md
# Options: -y to skip confirmation
st version
st update # Options: --force
Global Options
| Flag | Short | Description |
|---|---|---|
--token | API token override | |
--api-url | API base URL override | |
--output | -o | Output format: json, text |
--yes | -y | Skip confirmations |
Flag Aliases
| Long | Short | Description |
|---|---|---|
--space | -s | Space (name or numeric ID) |
--board | -b | Board (name or numeric ID) |
--list | -l | List (name or ID) |
--card | -c | Card ID |
--assignee | -a | Assignee — card commands (name, email, ID, or ‘me’) |
--tag | -t | Tag filter — cards list (comma-separated names or IDs) |
--owner | Owner — projects/epics only (name, email, or user ID) | |
--user | -u | User (name, email, or user ID) |
--archived | Include archived items |
Configuration
Precedence (highest first):- CLI flags (
--token,--api-url,--output/-o) - Environment variables (
ST_TOKEN,ST_API_URL,ST_OUTPUT_FORMAT) - Config file
~/.config/superthread/config.yaml(created byst auth login)
Delete Confirmation
All delete commands prompt before executing. Use--yes/-y to skip (useful for scripts).
Confirmed deletes: spaces, boards, cards, projects, pages, notes, comments, replies, team members.