SlateDocs
Use Slate

Usage, changes and sync

Part of Toolkit.

How often each item ran#

Skills, Commands, Subagents and MCP servers rows show runs in this project's sessions over 30 days: ran 4× · 3h ago, then 1 failed or 1 stopped by you. Hover for runs by tool.

Row saysWhen
not run in 30 daysUnused.
not recorded yetNo session in the project has ended.
not run since (a date)Fewer than 30 days recorded.
not measuredNo tool that reads the item records runs.
KindTools whose sessions show it
SkillsEvery agent: a slash command, a Skill call, or a read of the skill's SKILL.md
CommandsClaude Code
SubagentsClaude Code: the subagent type each Task call names
MCP serversClaude Code and Codex, which name each call mcp__<server>__<tool>

When a turn ends, Slate reads the transcript and stores one row per use, with the session's receipt, in this computer's workspace database. Rereading replaces a session's rows. A worktree session counts for the main checkout. No model call.

Failed is a call that returned an error (Cursor and skills record no results, so never fail). Stopped by you is an interrupted turn while the item ran (Claude Code interrupt, Codex aborted turn); it is not counted as failed.

After you accept an Improve, Slate keeps the 30 days before (runs, runs stopped). Thirty days later, hover shows: The 30 days before: ran 6×, 4 stopped by you. The 30 days after: ran 4×, 1 stopped by you. Until then it gives the end date. Only the latest Improve per item shows.

The changes chip#

With Toolkit changes the header shows N changes to commit in Code (opens Changes on that project). It counts every file Toolkit writes, live. Your agents has none (not in git). Files that can hold secrets or local paths (.mcp.json, .cursor/mcp.json, .claude/settings.json and the like) are listed unticked with a note; tick one only to commit it.

The sync pill#

With .slate/, the toolbar pill (In sync, 1 agent behind) is the only place Toolkit shows whether agents match. Click for a popover listing only agents needing sync, with what is off (e.g. Skills changed), Check again and Sync now.

Slate watches .slate/, AGENTS.md and CLAUDE.md and syncs shortly after any change, from Slate, a terminal, an agent or git pull. Editing a skill needs no sync (tools read through links); adding, removing or renaming one, or changing config.toml or the rules file, does. This sync writes only inside the project, and runs only in a project you chose: one you added, one you adopted Slate in, or one on its own. A project Slate only found in a group's folder (one you cloned there, say) is synced only when you press Sync now, until you add it or adopt Slate in it. Sync now and yarn studio sync also write MCP servers machine-wide (Generated adapters). A Toolkit step (a sync, a check, a skill change) that has not finished after 2 minutes is stopped, with whatever it started, and a message names the step.

Last updated