inline-cli

Inline CLI

Global flags

• --json: Output raw JSON payloads (proto/RPC results) to stdout (available on all commands).
• When --json is set and a command fails, the CLI prints a structured error JSON to stderr: {"error":{"code","message","hint","examples"}} and exits non-zero.
• Table-only convenience flags are disabled in --json mode. Specifically: inline users list --filter/--ids/--id, inline bots list --filter/--ids/--id, and inline chats list --ids/--id.
• inline chats list --json still supports --filter, --limit, and --offset for pre-filtered/paginated payloads.
• Destructive commands never prompt in --json mode; pass --yes explicitly.
• --pretty: Pretty-print JSON output (default).
• --compact: Compact JSON output (no whitespace).

Subcommands

auth

• inline auth login [--email you@x.com | --phone +15551234567]
• Run an interactive login flow.
• If code is wrong, prompt to try again or edit email/phone (no hard exit).
• inline auth me
• Fetch and print the current user (verifies your token is still valid).
• inline auth logout
• Clear the stored token and current user.

shortcuts and aliases

• inline me and inline whoami
• Shortcut for inline auth me.
• inline search ...
• Shortcut for inline messages search ....
• inline chat ..., inline thread ..., inline threads ...
• Aliases for inline chats ....
• inline bot ...
• Alias for inline bots ....

chats

• inline chats list
• List chats with human-readable names, unread count, and last message preview (sender + text in one column).
• inline chats list --json --filter "launch"
• Same GetChatsResult JSON payload, but pre-filtered by chat name/space/id for agent pipelines.
• inline chats get [--chat-id 123 | --user-id 42]
• Fetch a chat (thread or DM) by id.
• inline chats participants --chat-id 123
• List participants for a chat, including join date.
• inline chats add-participant --chat-id 123 --user-id 42
• Add a user to a chat.
• inline chats remove-participant --chat-id 123 --user-id 42
• Remove a user from a chat.
• inline chats create --title "Project" [--space-id 31] [--description "Spec"] [--emoji ":rocket:"] [--public] [--participant 42]
• Create a new chat or thread. If --public is set, participants must be empty.
• inline chats create-dm --user-id 42
• Create a private chat (DM).
• inline chats update-visibility --chat-id 123 [--public | --private --participant 42 --participant 99]
• Change a chat between public/private.
• --public cannot include participants.
• --private requires one or more --participant values.
• inline chats rename --chat-id 123 --title "New title" [--emoji "🚀"]
• Rename a chat or thread.
• inline chats mark-unread [--chat-id 123 | --user-id 42]
• Mark a chat or DM as unread.
• inline chats mark-read [--chat-id 123 | --user-id 42] [--max-id 456]
• Mark a chat or DM as read. If --max-id is omitted, marks through the latest message.
• inline chats delete --chat-id 123
• Delete a chat (space thread). Prompts for confirmation unless --yes is provided (--json requires --yes).

bots

• Alias: inline bot ... maps to inline bots ....
• inline bots list [--filter "name"] [--ids | --id]
• List bots you can access.
• inline bots create --name "Build Bot" --username build_bot [--add-to-space 31]
• Create a bot. Token is not printed in table output; use inline bots reveal-token explicitly. JSON includes the token.
• inline bots reveal-token --bot-user-id 42
• Print (or JSON-return) an existing bot token by bot user id.

typing

• inline typing start [--chat-id 123 | --user-id 42]
• Send a "typing" compose action.
• inline typing stop [--chat-id 123 | --user-id 42]
• Clear the compose action (stop typing).

users

• inline users list [--filter "name"] [--ids | --id]
• List users that appear in your chats (derived from getChats).
• --filter matches name, username, email, or phone.
• --ids prints one user id per line.
• --id requires exactly one match and prints that id.
• inline users get --id 42
• Fetch one user by id (from the same getChats payload).

spaces

• inline spaces list
• List spaces referenced by your chats (derived from getChats).
• inline spaces members --space-id 31
• List members in a space.
• inline spaces invite --space-id 31 [--user-id 42 | --email you@x.com | --phone +15551234567] [--admin] [--public-chats]
• Invite a user to a space (role is optional; defaults to server behavior).
• inline spaces delete-member --space-id 31 --user-id 42
• Remove a member from a space (prompts for confirmation; use --yes to skip; --json requires --yes).
• inline spaces update-member-access --space-id 31 --user-id 42 [--admin | --member] [--public-chats]
• Update a member's access/role. Provide --admin or --member (and optional --public-chats).

notifications

• inline notifications get
• Show current notification settings.
• inline notifications set [--mode all|none|mentions|only-mentions|important] [--silent | --sound]
• Update notification settings.

update

• inline update
• Download and install the latest release for this machine.

doctor

• inline doctor
• Print diagnostic info (system, config, paths, auth state).

tasks

• inline tasks create-linear --chat-id 123 --message-id 456 [--space-id 31]
• Create a Linear issue from a message.
• inline tasks create-notion --chat-id 123 --message-id 456 --space-id 31
• Create a Notion task from a message.

schema

• inline schema proto
• Print bundled protobuf source files.

messages

• inline messages list [--chat-id 123 | --user-id 42] [--limit 50] [--offset-id 456] [--translate en] [--since "yesterday"] [--until "today"]
• List chat history for a chat or DM.
• --translate <lang> fetches translations and includes them in output.
• inline messages export [--chat-id 123 | --user-id 42] [--limit 50] [--offset-id 456] [--since "1w ago"] [--until "today"] --output PATH
• Export chat history to a JSON file.
• inline messages search [--chat-id 123 | --user-id 42] --query "onboarding" [--query "alpha beta"] [--limit 50] [--since "today"] [--until "tomorrow"]
• Search messages in a chat or DM.
• --query is repeatable; each query can contain space-separated terms (ANDed within a query, ORed across queries). Extra whitespace is collapsed.
• --since and --until accept relative time expressions like yesterday, 2h ago, monday, 2024-01-15, or RFC3339.
• inline messages get --chat-id 123 --message-id 456 [--translate en]
• Fetch one full message by id (includes media + attachments).
• inline messages send [--chat-id 123 | --user-id 42] [--text "hi" | --message "hi" | --msg "hi" | -m "hi"] [--stdin] [--reply-to 456] [--mention USER_ID:OFFSET:LENGTH ...] [--attach PATH ...] [--force-file]
• Send a message (markdown parsing enabled). Mentions are provided via --mention with UTF-16 offsets.
• --stdin reads message text from stdin.
• --attach is repeatable. Each attachment is sent as its own message; --text is reused as the caption.
• Folders are zipped before upload. Attachments over 200MB are rejected.
• --force-file uploads photos/videos as files (documents).
• --mention is repeatable and must match the message text (user_id:offset:length with UTF-16 units).
• inline messages forward --from-chat-id 123 --message-id 456 --to-chat-id 789 [--no-header]
• Forward one or more messages between chats or DMs.
• Repeat --message-id to forward multiple messages.
• inline messages edit [--chat-id 123 | --user-id 42] --message-id 456 [--text "updated" | --message "updated" | --msg "updated" | -m "updated" | --stdin]
• Edit a message by id.
• inline messages delete [--chat-id 123 | --user-id 42] --message-id 456 [--message-id 789]
• Delete one or more messa