Woes Terminal

Woes Terminal is an in-app command console for operators and developers who want to move through the workspace quickly. It runs inside Woes, uses your signed-in account, and follows the same workspace permissions as the rest of the platform. Use it to:

Jump between Inbox, Issues, Clients, Agents, Context Library, Team Chat, Analytics, and Settings.
List and inspect conversations, issues, clients, agents, context sources, notifications, tags, and workspace stats.
Reply to conversations, close or reopen conversations, set priority, assign conversations to yourself, and archive conversations when your role allows it.
Create, update, close, or delete issues.
Add API context sources.
Return raw JSON for supported data commands when you need a quick structured snapshot.

Woes Terminal is not a separate public REST API key or an installed desktop CLI. It is a browser-based operator tool inside the Woes app.

Open Terminal

You can open Terminal in two ways.

Use the global overlay

Click the terminal button in the workspace header, next to the notification bell.

Use the keyboard shortcut

Press Ctrl + Backquote on Windows/Linux or ⌘ + Backquote on macOS. The overlay opens above the page you are already using.

Open the full page

Go to Developer tools -> Terminal in the app, or run open terminal from the overlay.

The overlay closes when you press Esc, click outside it, or run a navigation command. The full-page terminal stays open like any other workspace page.

How It Works

Terminal commands run with your current signed-in Woes session. If you can do something in the app, Terminal can usually do the matching supported command. If your role does not allow an action, the command fails with the same kind of permission error you would see in the app. Terminal follows these rules:

Rule	What it means
Workspace scoped	Commands only read or change records in the workspace you are signed into.
Role aware	Your operator permissions still apply. Terminal does not bypass access rules.
Same source of truth	Commands use the same workspace data shown in Inbox, Issues, Clients, Agents, Context Library, and Analytics.
Browser based	No install command, local token, or separate machine credential is required.
JSON optional	Add `--json` to supported data commands to show the raw response shape.

Command Syntax

Commands use a simple shell-style format:

command subcommand value --flag value --other=value --json

Terminal supports:

Pattern	Example
Positional values	`inbox view 53113c6c`
Quoted text	`reply 53113c6c "Thanks, we are checking this now."`
Long flags	`issues --status new --priority high`
Equals flags	`clients --search=acme`
Short flags	`inbox -n 10`
Boolean flags	`agents --json`

Use help to list commands and help <command> to see usage examples for one command.

help
help inbox
help reply

Keyboard Controls

Key	Action
`Enter`	Run the current command.
`ArrowUp`	Recall the previous command.
`ArrowDown`	Move forward through command history.
`Tab`	Complete a command name when there is one match, or show matches.
`Ctrl + L` or `⌘ + L`	Clear the terminal scrollback.
`Esc`	Close the overlay terminal.

Core Commands

Get Help

help
help issues
help context

Check Your Session

whoami
me

Shows the signed-in operator, email, workspace id, user id, and permission count.

Workspace Stats

stats
dashboard

Returns quick counts for conversations, open conversations, issues, clients, and agents.

Clear, History, Echo, And Theme

clear
history
echo "Checking the inbox"
theme

theme toggles the workspace between light and dark mode. Use open to jump around Woes.

open
open inbox
open issues
open clients
open context
open team-chat
open settings
open terminal

Aliases also work:

go issues
nav analytics
goto clients
cd context

Deep-link a conversation from Terminal:

open inbox 53113c6c-5d49-41b0-8b20-19dc8f5a1234

Inbox And Conversations

List Conversations

inbox
inbox list
inbox --status open
inbox --channel "Live chat"
inbox --limit 10
inbox --json

Aliases:

conversations
convos

Formatted output includes the conversation id, customer, channel, status, priority, and last activity.

ID            CUSTOMER              CHANNEL    STATUS  PRIORITY  LAST
────────      ────────────────────  ───────    ──────  ────────  ─────
53113c6c…1234 Chris Santangelo      Live chat  open    medium    4m ago

View A Conversation

inbox view 53113c6c-5d49-41b0-8b20-19dc8f5a1234
conversations view 53113c6c-5d49-41b0-8b20-19dc8f5a1234

Terminal shows conversation details and the most recent transcript messages. Use --json when you need the raw structured conversation object.

Reply To A Conversation

reply 53113c6c-5d49-41b0-8b20-19dc8f5a1234 "Thanks, I am checking that now."

The reply is sent as the signed-in operator. It appears in the conversation transcript and follows the same delivery behavior as replying from Inbox.

Manage Conversation State

close 53113c6c-5d49-41b0-8b20-19dc8f5a1234
solve 53113c6c-5d49-41b0-8b20-19dc8f5a1234
reopen 53113c6c-5d49-41b0-8b20-19dc8f5a1234
priority 53113c6c-5d49-41b0-8b20-19dc8f5a1234 high
assign 53113c6c-5d49-41b0-8b20-19dc8f5a1234 me
archive 53113c6c-5d49-41b0-8b20-19dc8f5a1234

Terminal assignment currently supports assigning a conversation to yourself. Use Inbox when you need to assign a conversation to another teammate.

Issues

List Issues

issues
issues list
issues --status new
issues --priority high
issues --limit 10
issues --json

Formatted output includes issue id, subject, status, priority, assignee, and last update.

View An Issue

issues view 90c018aa-d413-49fe-a529-ec7fc888d14b
issue view 90c018aa-d413-49fe-a529-ec7fc888d14b

Create An Issue

issues create "OAuth callback fails on Safari" --priority high --description "User signs in but lands back on marketing."

Update An Issue

issues update 90c018aa-d413-49fe-a529-ec7fc888d14b --status on_you
issues update 90c018aa-d413-49fe-a529-ec7fc888d14b --priority low
issues update 90c018aa-d413-49fe-a529-ec7fc888d14b --subject "OAuth callback follow-up"

Close Or Delete An Issue

issues close 90c018aa-d413-49fe-a529-ec7fc888d14b
issues delete 90c018aa-d413-49fe-a529-ec7fc888d14b

Delete is permanent for the issue record. Use it carefully and only when your workspace process allows removal.

Clients

List Clients

clients
clients list
clients --search acme
clients --health healthy
clients --limit 20
clients --json

View A Client

clients view acme
clients view client_123

Client output shows health, open work, message count, visits, contacts, channels, and last activity.

Create A Client

clients create "Acme Inc" --name "Jane Lee" --email jane@acme.com

Use this when you need to create a customer account before support activity has created one automatically.

Agents

List the workspace agents and their enabled state:

agents
agents list
agents --json

Aliases:

agent

Context Library

List Context Sources

context
context list
sources
context --json

Terminal shows source id, source name or URL, ingestion status, and endpoint count when available.

Add A Context Source

context add https://docs.acme.dev/openapi.json
context add https://api.acme.dev/openapi.yaml

Woes starts ingestion for the URL. Use Context Library in the app for deeper source review, authentication settings, rescan controls, and troubleshooting.

Workspace Commands

Analytics

analytics
analytics --json

The formatted view summarizes recent conversation analytics by status and channel.

Notifications

notifications
notifs
notifications read

notifications read marks all notifications as read for your signed-in operator.

JSON Examples

Add --json to supported list/view commands:

inbox --status open --limit 5 --json
issues --priority high --json
clients --search acme --json
agents --json
context --json
analytics --json
notifications --json

Use JSON output when you want to copy a quick structured snapshot into a report, debug a workflow, or compare what the UI is showing.

Treat JSON output as workspace data. Do not paste customer transcripts, emails, private context, or internal notes into public channels.

Permissions And Safety

Terminal is designed to be fast without being more powerful than the app.

You must be signed into Woes.
Commands run in the active workspace.
Your role and permissions still apply.
Customer data shown in Terminal follows the same workspace data boundaries as Inbox, Issues, Clients, and Context Library.
Terminal does not expose provider secrets, API credentials, or hidden system prompts.
Terminal is intended for operators and admins, not public website visitors.

Current Boundaries

Terminal is intentionally focused on high-frequency operator work.

Area	Current behavior
Teammate assignment	You can assign a conversation to yourself. Assigning another teammate is handled in Inbox.
Macros	Run macros from Inbox, not Terminal.
AI takeover	Review and take over AI-handled conversations from Inbox.
Bulk destructive actions	Use the app for review-heavy workflows.
External scripts	Use the public REST API for server-side automation outside the browser.

Troubleshooting

Issue	What to do
Terminal says you are not authenticated	Refresh Woes and sign in again.
A command says permission denied	Ask a workspace admin to review your role and permissions.
A command cannot find a record	Confirm the id is from the active workspace and that the record still exists.
`--json` output is too large to scan	Add filters such as `--limit`, `--status`, `--priority`, or `--search`.
Tab completion shows multiple commands	Type a few more letters, then press `Tab` again.
You need a teammate assignment, macro, or AI takeover	Open the record in the app with `open inbox <id>` and use the full UI.

Woes documentation

Woes Terminal

Woes Terminal

Open Terminal

How It Works

Command Syntax

Keyboard Controls

Core Commands

Get Help

Check Your Session

Workspace Stats

Clear, History, Echo, And Theme

Navigation Commands

Inbox And Conversations

List Conversations

View A Conversation

Reply To A Conversation

Manage Conversation State

Issues

List Issues

View An Issue

Create An Issue

Update An Issue

Close Or Delete An Issue

Clients

List Clients

View A Client

Create A Client

Agents

Context Library

List Context Sources

Add A Context Source

Workspace Commands

Tags

Analytics

Notifications

JSON Examples

Permissions And Safety

Current Boundaries

Troubleshooting

​Woes Terminal

​Open Terminal

​How It Works

​Command Syntax

​Keyboard Controls

​Core Commands

​Get Help

​Check Your Session

​Workspace Stats

​Clear, History, Echo, And Theme

​Navigation Commands

​Inbox And Conversations

​List Conversations

​View A Conversation

​Reply To A Conversation

​Manage Conversation State

​Issues

​List Issues

​View An Issue

​Create An Issue

​Update An Issue

​Close Or Delete An Issue

​Clients

​List Clients

​View A Client

​Create A Client

​Agents

​Context Library

​List Context Sources

​Add A Context Source

​Workspace Commands

​Tags

​Analytics

​Notifications

​JSON Examples

​Permissions And Safety

​Current Boundaries

​Troubleshooting

​Related Docs

Woes Terminal

Open Terminal

How It Works

Command Syntax

Keyboard Controls

Core Commands

Get Help

Check Your Session

Workspace Stats

Clear, History, Echo, And Theme

Navigation Commands

Inbox And Conversations

List Conversations

View A Conversation

Reply To A Conversation

Manage Conversation State

Issues

List Issues

View An Issue

Create An Issue

Update An Issue

Close Or Delete An Issue

Clients

List Clients

View A Client

Create A Client

Agents

Context Library

List Context Sources

Add A Context Source

Workspace Commands

Tags

Analytics

Notifications

JSON Examples

Permissions And Safety

Current Boundaries

Troubleshooting

Related Docs