# Slate

> Slate is one home for every AI coding tool on a Mac. It shows every AI coding session live, across 16 agents, and gives them one memory, one set of skills and rules (Toolkit) and one set of connections (Connect). Everything is stored locally in SQLite. Slate is also an MCP server: a connected agent reads and writes the workspace through it.

How to use these docs: every page below is plain markdown at the link given. Fetch only the pages a question needs; `llms-full.txt` beside this file holds every page in one file. "MCP tool reference" lists the tools Slate gives an agent. The guide describes the app as shipped; where it says what Slate does not do, believe it.

## Get started

- [Welcome to Slate](https://liozelmalem-star.github.io/slate-releases/docs/index.md): One home for every AI coding tool you use. See every AI session on your Mac live, and give all 16 tools one memory, one set of skills and rules, and one set of connections. Your work stays on your Mac.
- [Install and first ten minutes](https://liozelmalem-star.github.io/slate-releases/docs/overview/getting-started.md): Install Slate, create your first docs, connect it to your agents as a shared memory, and run your first request in Home.
- [Core concepts](https://liozelmalem-star.github.io/slate-releases/docs/overview/concepts.md): The mental model behind Slate — docs as the universal unit, memory as a shared MCP layer, agents that drive your CLIs, and Toolkit as one playbook for every tool.
- [Uninstalling](https://liozelmalem-star.github.io/slate-releases/docs/overview/uninstalling.md): How to take Slate off a Mac, what it puts back, and why your workspace is kept unless you ask for it to go.

## Use Slate

- [Sessions](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions.md): Every AI-CLI session on this machine, live. Who is working, who needs you, where each runs, and what each changed.
  - [The map and the list](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/list.md): The Sessions map and rail in detail: how the tree is drawn, what a row shows, the row menu, parking, Just finished and past sessions.
  - [Start a session](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/start.md): Start a session from the list or a doc, open any folder, chat instead of a terminal, open a plain shell, take over a session from your terminal, or hand one back.
  - [Worktrees](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/worktrees.md): The worktree form, carry-over, Then run and On remove commands, the port each worktree gets, Run preview with Pick, and how a session's worktree is cleaned up.
  - [Cloud sessions and phone](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/cloud.md): Run a session on your agent's computer so it keeps going while yours sleeps, or continue a running session from your phone.
  - [The terminal and the side panel](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/terminal.md): The hosted terminal and its Conversation view, the side panel with Details, Changes, Turns and a widget, the timeline, and what each session recorded and was given.
  - [Tabs, columns and names](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/tabs.md): Several sessions in one strip of tabs, up to four columns side by side, naming a session, and how agents in one project are told about each other.
  - [Review the branch](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/review.md): Review and merge a finished branch, commit and sync from the Changes panel, read the whole branch as one doc, and rewind a session to the start of any turn.
  - [Files, memories and editing](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/files.md): Open the files a session changed beside it, find any file with ⌘P, read blame and history, see what memories say about each line, comment on changes, and edit.
  - [Session flow](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/flow.md): A session's flow shows where it stands in its work: Overview, Plan, Build, Check, Land. How each step lights, how the goal is found, and what the colours mean.
  - [How status works](https://liozelmalem-star.github.io/slate-releases/docs/features/sessions/status.md): How Slate decides whether a session needs you, is working or is idle, what it cannot see, and how the live list stays current.
- [Memory](https://liozelmalem-star.github.io/slate-releases/docs/features/memory.md): Slate's memory is shared by every agent through an MCP server, filled in automatically, and stored as docs you can read and fix.
  - [Session capture](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/session-capture.md): Slate captures your AI sessions from 16 agents, by watching transcript files or reading a tool's own database.
  - [Recall and remember](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/recall-remember.md): How memory reaches an AI session (an index at the start, a search, a lesson on the tool call) and how it saves, cites and corrects what it learned.
    - [What a session is given at the start](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/session-start-brief.md): The brief every AI session gets at the start, how it is sent to look memory up, where Slate hands out the memory index, and the rules that filter it.
    - [Lessons](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/lessons.md): A lesson is a memory that says what to do in a situation and arrives on the tool call it is about.
    - [Remember](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/remember.md): How a session saves one typed memory with remember, corrects a wrong one, and which writes are refused.
    - [Tidying and measuring memory](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/tidy-and-measure.md): Tidy a project's memory with proposals you accept, how declines and lessons turn into proposals, and how to measure whether memory helps.
  - [Decisions and memories](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/decisions-and-facts.md): Two kinds of durable memory: decisions are logged choices with their reasoning, other memories are lasting knowledge ranked for recall.
  - [Memory graph](https://liozelmalem-star.github.io/slate-releases/docs/features/memory/map.md): A map of your memories on the files they are about, coloured by whether sessions use them, with a list to read, search, correct and retire them.
- [Toolkit](https://liozelmalem-star.github.io/slate-releases/docs/features/studio.md): Write your instructions and skills once, then sync them to your agents from one source.
  - [Adding items](https://liozelmalem-star.github.io/slate-releases/docs/features/studio/adding.md): How to add a skill, command, subagent, rule, output style, instructions file, MCP server, hook or plugin in Toolkit, and what each form writes.
  - [Editing, removing and your agents](https://liozelmalem-star.github.io/slate-releases/docs/features/studio/editing-and-agents.md): How to edit and remove Toolkit items, choose which agents read a skill, and manage what is kept for every project under Your agents.
  - [Usage, changes and sync](https://liozelmalem-star.github.io/slate-releases/docs/features/studio/usage-and-sync.md): How Toolkit shows how often each item ran, the changes chip, and the sync pill.
  - [Suggestions](https://liozelmalem-star.github.io/slate-releases/docs/features/studio/suggestions.md): Toolkit's Suggestions tab: the five kinds of change proposed to a project's AI setup, when each appears and what its button does.
  - [Start using .slate](https://liozelmalem-star.github.io/slate-releases/docs/features/studio/start-using-slate.md): How a project without .slate/ adopts it: what Start using .slate creates, moves and protects.
  - [Project environments](https://liozelmalem-star.github.io/slate-releases/docs/features/studio/cli-profiles.md): Which account each agent runs under, per workspace and per group or project, so work stays on the work login. Covers sessions you start yourself in a terminal.
- [Home](https://liozelmalem-star.github.io/slate-releases/docs/features/agent.md): Home, Slate's in-app AI agent: it reads and writes your workspace, reaches the MCP tools you connect, and does its routing in code so a light model works.
  - [Approvals, Stop and agent differences](https://liozelmalem-star.github.io/slate-releases/docs/features/agent/approvals.md): How Home's agent asks before it acts, how autonomy and Stop work, and what differs between Claude Code, Codex, Cursor, OpenCode, Gemini and the newer agents.
- [Tasks](https://liozelmalem-star.github.io/slate-releases/docs/features/tasks.md): Tasks — what waits on you, in four sections (To-dos, Issues, Reviews, Messages), plus today's meetings, reminders, agent runs and receipts.
  - [Where tasks come from](https://liozelmalem-star.github.io/slate-releases/docs/features/tasks/sources.md): How Tasks reads GitHub, Jira, Slack and Gmail, apps connected from Slate and apps read with a pasted token, and how Messages is limited to the open workspace.
  - [How Slate learns an app](https://liozelmalem-star.github.io/slate-releases/docs/features/tasks/learning.md): How Slate learns to read a tracker app on its own, how Teach Slate works, the write-word safety check, and what Tasks stores on disk.
  - [Agent runs](https://liozelmalem-star.github.io/slate-releases/docs/features/tasks/agent-runs.md): Agent runs — start one from a task, step through Plan, Build, Check and Ship with your approvals, use Autopilot, and read the agent run rules that guard it.
  - [Agent runs: Workflow](https://liozelmalem-star.github.io/slate-releases/docs/features/tasks/workflow.md): The six kinds of work an agent run knows, the one skill each runs per project, how Slate suggests a skill and how you change the rule.
  - [Receipts](https://liozelmalem-star.github.io/slate-releases/docs/features/tasks/receipts.md): A receipt is what an AI session ran, checked against what it said — what it shows, what flags it, how to copy or share it, and what Slate stores.
- [Docs and the block editor](https://liozelmalem-star.github.io/slate-releases/docs/features/docs.md): Everything in Slate is a doc: nested, typed, and edited in a keyboard-first block editor. Covers the editor, the doc tree, Code, Trash, and the group and project docs.
  - [The doc tree](https://liozelmalem-star.github.io/slate-releases/docs/features/docs/tree.md): The doc tree in Projects — the Overview, Docs, Trash, ordering, nesting, grouping and a group's or project's Settings.
  - [Files and changes](https://liozelmalem-star.github.io/slate-releases/docs/features/docs/code.md): The Code view of a project — the Files tree, file tabs with blame and changes, and the Changes list for committing.
  - [Typed docs and hierarchy](https://liozelmalem-star.github.io/slate-releases/docs/features/docs/typed-docs.md): A doc's doc_type pre-fills a template. Its status tracks progress. Both place it in the group, project, branch hierarchy that lets memory tools resolve targets.
  - [Missions](https://liozelmalem-star.github.io/slate-releases/docs/features/docs/missions.md): The `mission` doc is a legacy type. Also covers how agents report progress on a branch, a label on the project's records, and how Slate offers a doc at each milestone.
- [Automations](https://liozelmalem-star.github.io/slate-releases/docs/features/loop.md): Automations work for you on a trigger, inside rules you set. Give one a job, reply in its thread, and say yes or no before it changes anything.
  - [Recent tasks](https://liozelmalem-star.github.io/slate-releases/docs/features/loop/recent-tasks.md): The Recent tasks step of an automation — what context it reads, how it checks your live tools, the report columns, and the prompt variables.
  - [Built-in automations](https://liozelmalem-star.github.io/slate-releases/docs/features/automations.md): The thirteen things Slate does on its own, what each is for, and how to switch them off.
- [Artifacts](https://liozelmalem-star.github.io/slate-releases/docs/features/artifacts.md): What your agents publish for you: an HTML page, chart, report or Markdown note, kept in your workspace with every version.
  - [Widgets](https://liozelmalem-star.github.io/slate-releases/docs/features/widgets.md): A widget is a small program your agent builds inside Slate and shows as a card on a tab. It reads only what the tab shows, acts only through permissions you allow, and has no internet. Build, change, restore and trash widgets here.
  - [Widget API](https://liozelmalem-star.github.io/slate-releases/docs/features/widgets-api.md): Every call, hook and part a widget can import from Slate, with what each one returns and which permission it needs.
- [Activity and analytics](https://liozelmalem-star.github.io/slate-releases/docs/features/activity.md): Your AI sessions over time: the dashboard, where its numbers come from, and how far back it reaches.
- [Connect](https://liozelmalem-star.github.io/slate-releases/docs/features/connect.md): The screen for how a workspace reaches outside itself: which agents it runs, which apps it connects, and what it can import from other tools.
  - [Import](https://liozelmalem-star.github.io/slate-releases/docs/features/import.md): Connect › Import brings in the projects your editors already know, so Projects does not start empty. Slate reads nothing until you pick an editor.
  - [A tool's dialog](https://liozelmalem-star.github.io/slate-releases/docs/features/connect/dialog.md): What a tool's dialog in Connect shows: its MCP servers and their states, its profile, and its models.
  - [How Slate installs into a tool](https://liozelmalem-star.github.io/slate-releases/docs/features/connect/how-slate-installs.md): How connecting a tool installs Slate (plugin or config hooks, one MCP entry), what is written, what a session shows, what turning off restores, and how to check it.
  - [Integrations](https://liozelmalem-star.github.io/slate-releases/docs/features/connect/integrations.md): Connect an app such as GitHub, Jira or Notion to a workspace: sign-in per app, what each state means, and how agents read it.
  - [Connected MCP tools](https://liozelmalem-star.github.io/slate-releases/docs/features/agent/connected-tools.md): Home reaches every MCP server the agent's own CLI declares. Not the same as Slate as an MCP server.
- [Workspaces](https://liozelmalem-star.github.io/slate-releases/docs/features/workspaces.md): A workspace is one store, shared or private. Switch into one from the top of the rail and the whole app works inside it.
  - [Working in a shared workspace](https://liozelmalem-star.github.io/slate-releases/docs/features/workspaces/sharing.md): Inside a shared workspace everything is shared. How to move work in, what read-only means, and how memory and artifacts travel.
  - [Workspaces and invites](https://liozelmalem-star.github.io/slate-releases/docs/features/workspaces/workspaces-and-invites.md): Accounts, workspaces, roles and invitations, and what a role controls on the server and on your machine.
- [Search and command palette](https://liozelmalem-star.github.io/slate-releases/docs/features/search.md): Press ⌘K to run an action, jump to a doc or search your workspace. Also the cheatsheet, rebindable shortcuts, the sidebar, the rail and tabs.
- [Trash](https://liozelmalem-star.github.io/slate-releases/docs/features/trash.md): Docs and widgets you move to Trash stay there until you restore them or delete them forever.
- [Themes](https://liozelmalem-star.github.io/slate-releases/docs/features/theming.md): Slate's two themes, Mint and Forest, the brand colour, the workspace palette and the interface zoom.

## Reference

- [Slate as an MCP server](https://liozelmalem-star.github.io/slate-releases/docs/features/mcp-server.md): Slate as an MCP server: one local server that gives every agent the same workspace and memory, under a recall / remember contract.
  - [Connecting your agents](https://liozelmalem-star.github.io/slate-releases/docs/features/mcp-server/connecting.md): Connect any of 16 agents to Slate's MCP server: from the app, or by hand.
- [MCP tool reference](https://liozelmalem-star.github.io/slate-releases/docs/features/mcp-server/tools.md): Every tool Slate's MCP server exposes, with arguments and defaults: docs, memory, workspaces, activity, your Tasks list, connected apps, other agents, artifacts, widgets, setup, automations, agent runs and capability discovery.
  - [Tool rules](https://liozelmalem-star.github.io/slate-releases/docs/features/mcp-server/tool-rules.md): The rules every Slate MCP tool call follows: which workspace a call reaches, what secrets are scrubbed, what an agent cannot do, and how a doc target resolves.
- [Curated MCP commands](https://liozelmalem-star.github.io/slate-releases/docs/features/agent/mcp-commands.md): How Home works on a light model: keyword routing picks one of Slate's own tools, the app prefills known args, and the model fills only the rest.
- [Agents and model providers](https://liozelmalem-star.github.io/slate-releases/docs/features/agent/brains.md): The 16 agents Slate drives, each a thin driver over a CLI you already have installed and signed in to, so there is no API key to paste.
- [Features by agent](https://liozelmalem-star.github.io/slate-releases/docs/features/agent/tool-features.md): Which agent has which feature in Slate, and why a gap is there. Every per-tool control reads this one table.
- [Settings](https://liozelmalem-star.github.io/slate-releases/docs/features/settings.md): What each Settings tab holds. Every tab is about this computer; what one workspace allows is in Connect.
- [Keyboard shortcuts](https://liozelmalem-star.github.io/slate-releases/docs/features/shortcuts.md): Every keyboard shortcut in Slate, grouped by where it works, and how to rebind one.

## Privacy & trust

- [Privacy and security](https://liozelmalem-star.github.io/slate-releases/docs/features/privacy-and-security.md): Slate keeps your workspace on your machine. Your sign-in, four standing exceptions, a problem report you send, requests you start and the connections you set up can send data out. Each is listed below with how to turn it off.
  - [Where each piece of data lives](https://liozelmalem-star.github.io/slate-releases/docs/features/privacy-and-security/where-data-lives.md): Where each kind of data Slate keeps is stored on your machine, and which of it is never shared or sent.
  - [Workspace sharing, precisely](https://liozelmalem-star.github.io/slate-releases/docs/features/privacy-and-security/sharing.md): What workspace sharing sends, what it withholds, what a widget or live artifact can reach, and how to switch sharing off or take back what you shared.
  - [Security details](https://liozelmalem-star.github.io/slate-releases/docs/features/privacy-and-security/security-details.md): How Slate protects its local server, tool configs, workspace files and backups, and what it does not encrypt.
- [Your data and export](https://liozelmalem-star.github.io/slate-releases/docs/features/data-and-export.md): Each workspace is one SQLite file on your machine. Export is a copy, the format is open, and your data outlives the app.
- [Licensing and updates](https://liozelmalem-star.github.io/slate-releases/docs/features/licensing.md): Free for individuals, Team plans coming. How updates arrive in steps, install when you quit, and what safe mode does.
- [Platform and availability](https://liozelmalem-star.github.io/slate-releases/docs/features/platform.md): Which platforms Slate runs on today, which have early builds, and how you install and remove it.
- [What Slate costs your machine](https://liozelmalem-star.github.io/slate-releases/docs/features/footprint.md): The most CPU, memory and disk Slate may use on your Mac, how the tests measure it, and how to check it yourself.

## Legal

- [Terms of use](https://liozelmalem-star.github.io/slate-releases/docs/legal/terms-of-use.md): The terms that govern your use of the Slate desktop application, including the license, acceptable use, warranty disclaimer, and third-party tools.
- [Privacy policy](https://liozelmalem-star.github.io/slate-releases/docs/legal/privacy-policy.md): How Slate handles your data: your work stays in local SQLite files on your device unless you deliberately share a workspace. Your account holds your name, email and plan.