# October: guide for AI agents

October is a workspace for personal AI bots, supported agent tools, applications, computers, and teammates. Use conversations to build features, review code, research ideas, or maintain documentation, then follow the work through files, worktrees, the task board, review, diffs, and merge.

Website: https://www.october.dev/
Download: https://www.october.dev/download
iPhone beta (TestFlight): https://testflight.apple.com/join/hWrmYT5X
Product documentation: https://www.october.dev/docs
Detailed Markdown guide: https://www.october.dev/docs/october.md
Concise index: https://www.october.dev/llms.txt
Full context: https://www.october.dev/llms-full.txt

## Personal bots

Give bots ongoing responsibilities, such as watching mentions, tracking competitors, or preparing a daily brief. Return to the same conversation as the work continues.

- Create bots for different jobs, such as building, reviewing, research, and documentation.
- Choose each bot's name, character, instructions, preferred supported agent and model, and workspace or worktree.
- Find bots in the sidebar and return to the same bot and its ongoing conversation.
- Connect supported agents and models, including existing agent subscriptions where supported. Each provider's authentication, permissions, usage, and limits still apply.
- Bot work belongs to the same project and review workflow as other agent work. You can also use an agent directly without creating a bot.

## Optional companions

The bot does the work; its fuzzy companion is an optional way to keep it nearby. Toggle each bot's paw icon to show or hide its companion independently. One or several can animate, wander, and settle onto surfaces inside October, including Canvas items, panels, and the chat composer. Drag a companion, or click it to open its bot's conversation.

Companions stay inside October. Hiding one does not remove the bot or its conversation. Companions are a supporting part of the workspace, not a requirement for using bots or agents.

## Tools beside Chat and on Canvas

Browsers, web and mobile previews, video editors, and slides can open in a column beside Chat. Computer and phone tools bring together Cloud Linux, iOS and Android simulators, Virtual Mac, and supported connected desktops.

Each tool is a Canvas item too. Connect agents to it, switch between Chat and Canvas, and return to the same running environment. Hiding the Chat column does not create a duplicate instance or stop the environment.

## Where work runs

October can run agents and code locally, on connected Macs, Windows PCs, Linux machines, and Raspberry Pis, or in supported cloud environments. Viewing and controlling a connected desktop also requires a supported display service and permission; a headless host can run an agent without exposing a desktop.

Virtual Mac requires a supported Apple silicon Mac. Simulators, cloud computers, and connected desktops depend on the host, connection, enabled service, and plan. An iOS simulator is separate from controlling a physical iPhone. Cloud compute, device services, and model usage can have separate charges.

A persistent bot identity or saved conversation does not keep a sleeping or offline execution host running. Check the actual host and service when planning a long task.

## Collaboration and review

Agent Intercom lets connected supported sessions discover peers, exchange scoped context, ask questions, share results, and hand off work. Connections determine which agents and resources can collaborate. Teammates can join the shared workspace with permission.

Start with one clear task and add participants when needed. Keep parallel edits in separate worktrees, inspect commands, files, diffs, checks, and live previews, and follow the requested approval boundaries. October coordinates work; the human operator retains final decisions.

## Further reading

- [Getting started](https://www.october.dev/docs/october.md#quickstart)
- [Personal bots](https://www.october.dev/docs/october.md#personal-bots)
- [Tools and computers](https://www.october.dev/docs/october.md#tools-and-computers-beside-chat)
- [Agent Intercom](https://www.october.dev/agent-intercom)
- [Supported harnesses](https://www.october.dev/docs#harnesses)
- [Product comparisons](https://www.october.dev/comparisons)
- [Current plans and allowances](https://www.october.dev/pricing)
