Getting started

Requirements

Chittr is an early preview for macOS.

Gemini and Antigravity aren't supported in this preview.

Install

Install at least one provider CLI and sign in with your subscription. Chittr doesn't bundle provider CLIs or ask for their credentials.

Then install Chittr:

npm install -g @chittr/cli
chittr --version

Update

chittr update

Close any other Chittr rooms first. chittr update installs the latest release from npm. Then launch Chittr again. It doesn't change your config or chats, and it doesn't update provider CLIs.

Chittr 0.2.0 and earlier don't have chittr update. Update those once with npm install -g @chittr/cli@latest.

To uninstall, run npm uninstall -g @chittr/cli. Your config and chats stay in place.

Your first room

cd ~/Projects/your-project
chittr

• The directory you launch from is the room's workspace. Agents work in that directory only. Launching from a subdirectory gives them just that subdirectory, and Chittr doesn't search upward for a Git root.
• The first launch runs setup in the terminal. It lists the supported CLIs it finds (Codex, Claude and Grok), all checked. Up and Down move, Space toggles and Enter confirms. Escape cancels without writing anything. Setup then asks for your display name and confirms before writing ~/.agents/chittr.yaml.
• The new room can discuss and read files only. Edits, commands and network access start off. See permissions to grant them.
• Chat turns use your normal subscription allowance.

Run chittr doctor after setup. It checks each configured provider CLI and the file-tool sandbox without using a chat turn. It doesn't prove that a model will answer, or that the provider's terms permit your use.

In the browser

chittr --web

This starts a new chat and opens it in your browser. If the browser doesn't open, use the link printed in the terminal. Keep the terminal running while you use it. The browser shares the terminal's workspace, config, permissions and saved chats. See the browser interface for its controls.

What leaves your Mac

The Chittr app has no hosted account, analytics or telemetry. It talks to the provider CLIs you installed.

• Providers receive the conversation, your instructions, any images you send, and any file, skill or tool content their agents read.
• An @agent message isn't private. Every agent in the room sees it.
• Turning off network doesn't stop provider sign-in or inference traffic. It only covers what agents fetch for tasks.
• Chittr doesn't control whether a provider keeps your content or trains on it. Check your account settings with OpenAI, Anthropic and xAI.

On your Mac:

• Config lives in ~/.agents/chittr.yaml and the launch directory's .agents/chittr.yaml.
• Chats live under ~/.agents/chittr/sessions/, including attachments. Chittr doesn't encrypt them, and they don't expire.
• Agent CLIs can keep their own session records outside Chittr's storage.

A project's .agents/chittr.yaml can grant permissions and add instructions, so read it before launching in an unfamiliar project. Instruction files and installed skills can steer agents too.

Troubleshooting

Run chittr --help for every command and option, or see usage.