USAGE
continuity <command> [options] [arguments]
GLOBAL OPTIONS
Available for all commands:
-c, --config <path> Configuration file path
--user <text> Override user role for this session (human, agent, claude, ai, or username)
PROJECT COMMANDS
init Initialize continuity in current directory.
-r, --reinit Reinitialize existing project (doctor mode)
-y, --yes Auto-yes to all prompts (skip confirmations)
status Show continuity status.
-d, --detailed Show detailed information
MESSAGE COMMANDS
send [message] Send a message.
--to <choice> Recipient
-t, --title <title> Message title
-f, --file <path> Send from file
-e, --edit Open editor
check Check for messages.
-a, --all Show all messages (read and unread)
-r, --read-only Show only read messages
-u, --unread-only Show only unread messages (default behavior)
view <message_ref> View a message.
-p, --pager Use system pager instead of console output
mark <message_ref> Mark messages as read.
Supports: 1, 1-4, 1,3,5, all
-f, --force Skip stale check warning
new Start a new message.
-t, --title <title> Message title
--to <choice> Recipient
forward [message_ref] Forward a message.
--to <choice> Recipient
-t, --title <title> Message title
--from-ai Forward from AI agent mailbox
reply <message_ref> [reply_content] Reply to a message.
-f, --file <path> Reply from file
-e, --edit Open editor to compose reply
help Show complete CLI reference (same as --help).
USER COMMANDS
detect-user Detect if running in human or AI context.
--json Output in JSON format
-v, --verbose Show detection details
get-user Get current user setting from environment.
set-user <role> Output shell commands to set user role.
INBOX COMMANDS
inbox Inbox management commands.
inbox process Process files in inbox.
EXAMPLES
continuity send "Fix the login bug when you get a chance"
continuity send --file analysis.md --title "Code Review"
grep "TODO" *.py | continuity send --title "Outstanding work"
continuity send --ai --title "Status Update" "Auth is working"
continuity mark 1-3
continuity check --ai
continuity --user human send "I need help with this bug"
continuity --user agent check
See 'continuity help' for usage examples or 'continuity <command> --help' for command details.