SlateDocs
Use Slate

Connect

Connect (base of the rail, beside Trash and Settings) has three tabs, Agents, Integrations and Import. It is per workspace. What Slate runs on its own is in Automations › Built-in (Automations).

Contents#

Agents#

Connect an agent heads the tab. Under it: filters All 16, On this Mac, Connected, and Find an agent (by name). Each tool is a row: logo, name, and on the right one mark or button. A second line shows only when something differs from normal: a warning, a tool not on this Mac, or a profile or model you chose. Click the logo or name for the tool's dialog, which shows the profile it runs under (one login of the tool: its config folder) and its model. Your account is your Slate sign-in, in Settings.

Order, always: Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, OpenCode, Gemini, Cline, Grok Build, Kiro, Qwen Code, Droid, Hermes Agent, Goose, Kilo Code, Auggie. The first six are measured end to end. The ten newest show unverified in Features by Agent where no feature has run.

A row never moves. Turning a tool on or off changes only its mark and button; under Connected it keeps its row until you pick another filter.

The tool is…Mark or lineButton
Connected (Slate installed, workspace runs on it)a small green dot at the right edgeDisconnect, on hover
On this Mac, not connectednoneConnect
Not on this Macnone (greyed out)Install
Slate installed, nothing runs on ita grey line, Not turned on · sessions not recordedRemove Slate, Connect on hover
Running here, Slate not installed, or last session used another Slate installa grey line with an amber dot in frontConnect or Disconnect
Config could not be reada grey line with an amber dot in frontConnect

A state that needs you is said once: a small amber dot in front of a grey line. No pill repeats it, and every row is one height, so the dots line up.

A tool that is not installed#

The row reads Not on this Mac and has no Connect. Install shows the command with a copy button, a second way where there is one, how to sign in, what the account needs, and the vendor's guide link. Paste the command into Terminal, then press Check again; once Slate finds the CLI the row gets Connect. Slate never runs the command.

ToolInstallSign in
Claude Code`curl -fsSL https://claude.ai/install.sh \bash`run claude (needs a Pro, Max, Team, Enterprise or Console account)
Codexbrew install --cask codexrun codex, then Sign in with ChatGPT
Geminibrew install gemini-cliGEMINI_API_KEY, or a Gemini Code Assist licence. Personal Google accounts moved to Antigravity CLI
Cursor`curl https://cursor.com/install -fsS \bash`agent login
OpenCode`curl -fsSL https://opencode.ai/install \bash`run opencode, then /connect
GitHub Copilotbrew install --cask copilot-clicopilot login (needs a GitHub Copilot plan)
Antigravity`curl -fsSL https://antigravity.google/cli/install.sh \bash`run agy (personal Google accounts sign in here)
Clinenpm install -g clinecline auth
Grok Build`curl -fsSL https://x.ai/cli/install.sh \bash`grok login
Kiro`curl -fsSL https://cli.kiro.dev/install \bash`kiro-cli login
Qwen Codenpm install -g @qwen-code/qwen-coderun qwen, then /auth (needs a model provider)
Droid`curl -fsSL https://app.factory.ai/cli \sh`run droid (needs a Factory account or FACTORY_API_KEY)
Hermes Agent`curl -fsSL https://hermes-agent.nousresearch.com/install.sh \bash`hermes setup
Goose`curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh \CONFIGURE=false bash`goose configure
Kilo Codenpm install -g @kilocode/clikilo auth login
Auggienpm install -g @augmentcode/auggieauggie login (needs Node.js 20 or later and an Augment account)

A turn that cannot find a tool's CLI names the same command.

What Connect does#

Connect installs Slate into the tool's config directory (sessions captured, workspace readable and writable) and records that this workspace runs on the tool (Home, automations and skills use it). Disconnect undoes both (how).

  • If only one half is true the row says so, behind an amber dot, and Connect repairs it: Not turned on · sessions not recorded (in grey: Slate records only the agents a workspace turns on, so this one is a leftover), or Runs here, but Slate is not installed — sessions are not captured.
  • Remove Slate removes Slate from a tool this workspace does not run, leaving the workspace as is. The dialog names the config file Slate writes. Nothing is written until you connect, on first launch too.
  • Capture switch (Claude Code, Codex, Gemini; the ten newest have none yet): off stops recording that tool's sessions, and it stays connected. Cursor has Capture sessions / Stop capturing; OpenCode has none. Auto-capture in Automations › Built-in stops all.
  • A profile exists once per computer. If another workspace runs the same tool on the same profile, the row says Slate is installed here for Work and offers no Remove Slate (it would break that workspace); disconnecting only stops this workspace, and says so first.
  • Claude Desktop is connected with Claude Code, if installed; turning Claude Code off leaves it (one machine-wide setting). It gets Slate's tools and instructions but no hooks, so nothing is captured from it. Its chat has no folder, so the instructions ask it to call recall with the conversation's topic and the project's name. The Codex desktop app follows the Codex CLI's config.
  • VS Code chat is captured through the Copilot hooks file. VS Code runs agent hooks by default and reads ~/.copilot/hooks, where Slate writes its Copilot hooks, so connecting Copilot also captures VS Code chat. Slate tells the two apart by where the chat's transcript lives, and lists those sessions as VS Code, not GitHub Copilot.

With no tool, a workspace cannot chat on Home, run automations, build widgets, learn memories or record activity. The Automations, Memory, Activity, Widgets and Toolkit icons stay dimmed (hover says why; a click does nothing); Memory, Activity and Widgets open once they hold something. Home opens as a doc: the agents, what connecting one unlocks, Open Connect, and what works without AI (Tasks, Projects, Artifacts). Set a tool and all works with no reload.

One place decides which tool runs. Connect sets the workspace's tool; a group or project can override it. Home, the ⌘J panel, New session and automations show the tool that will run, linking here. With several tools in a project, Home and New session let you pick per turn. Sessions lists every AI session on the computer.

More: MCP servers, profiles and models; checking it works.

Integrations#

The Integrations tab holds this workspace's connected apps. Press Connect, approve on the app's sign-in page, and what you owe there shows in Tasks. List, states and per-app notes: Integrations.

Import#

The Import tab brings in the projects your editors already know: one tile per editor, with one button for the tile picked. Preview lists the folders before anything is added. See Import.

What is not here#

Settings holds Account, Workspaces, Appearance, Terminal, Keyboard and About. Moving, exporting and restoring a workspace file: Settings → Workspaces.

See also#

Last updated