Skip to main content

Your first chat

After you set up AI and connect at least one integration, start the assistant:

toby chat

toby with no subcommand also opens chat.

How chat uses integrations

All connected integrations (default) — Type your message normally. Toby merges tools from every connected chat integration (Gmail, Todoist, Slack, and so on).

One integration — Start your message with the integration name:

toby gmail summarize my unread email from today

Explicit set — Use --integration one or more times; remaining words are only the prompt:

toby chat --integration gmail --integration todoist "What should I focus on today?"

Inside the chat UI, type /integration to open a multi-select picker (Space toggles, Enter applies).

Useful slash commands

CommandWhat it does
/helpList slash commands and shortcuts
/configOpen the configure UI
/integrationChoose which integrations are active in this session
/personaSwitch persona
/skillsOpen the skills manager
/schedulesOpen the schedules manager
/newStart a new chat session
/sessionsBrowse saved sessions
/exitLeave chat

Press Shift+Tab to cycle personas without leaving chat.

Single-turn mode (no TUI)

For a one-shot answer in the terminal:

toby --no-tui "quick question about my inbox"

Debug pretreatment (optional)

To see which skills were selected and other pipeline details:

toby chat --debug

Next steps