Tutorials

These are arranged by how far into Synapse you are, not by feature. Each level assumes the one before it, and each tutorial ends by pointing at the next. If you are new, start at the top and stop whenever Synapse is doing what you need — most people never leave the second level, and that is a complete way to use it.

Level 1 · Newcomer

You have downloaded Synapse and want one tool remembering things. Roughly an hour for both.

1. Install and connect your first tools

   Start from the release archive, install the CLI, connect Codex, Claude Code, or pi, and verify all three MCP tools from the app, the terminal, and the tool itself.

2. Carry one decision between tools

   Store a confirmed convention in one tool, end the session, recover it in another, and inspect the exact record that made it across.

Level 2 · Daily driver

Synapse is connected and you use it every day. This level is about controlling what it remembers, what it can hand to a command, and what your tools know how to do.

1. Curate and optimize memory

   Add, find, correct, delete, and budget durable memory using both human-readable and JSON output. The one to read if recall is returning too much or the wrong thing.

2. Use a scoped secret in either shell mode

   Create a vaulted value, compare one-command and ambient loading without printing the value, and watch trust invalidate when the file changes.

3. Keep one skill library across every tool

   Write an Agent Skill once, install it into every connected tool, and see how Synapse tells a library that moved on from a copy somebody edited by hand.

4. Let your agents write skills

   Let a session write down a procedure it worked out, prove for yourself that it reaches no tool until you approve it, then correct it and take the correction back.

Level 3 · Team operator

You want several agents working at once on one job. This is the deepest level, and the one where agents touch real files on your machine — use a checkout you can restore.

1. Start a tool with everything in place

   Open a tool with memory, scoped credentials, and the project root already wired, without writing anything into that tool's own configuration.

2. Run a team of agents and drive it yourself

   Turn on the mesh, open a team, read what every agent is doing from one terminal, answer a worker that gets stuck, and shut it all down cleanly.

3. Hand a job to one agent and watch it grow a team

   Describe an outcome instead of picking a roster, answer the question only you can answer, and reach a worker directly without going through the agent that started it.

Level 4 · Maintainer

You are responsible for the store staying sound, or you are handing the machine on. Read these before you need them.

1. Export and restore safely

   Create a validated snapshot, make a reversible change, acquire the exclusive lifecycle lock, restore, and verify recovery.

2. Check, migrate, and remove Synapse

   Read a full health report, understand what a schema migration does, disconnect one tool, and remove everything while keeping your memory and your own files.

What every tutorial includes

Each one names its prerequisites, builds one complete outcome, includes verification you can observe rather than assume, calls out the security boundary it crosses, and ends with cleanup or the next safe step. Commands assume the installed synapse CLI is on PATH.

If you need exact command syntax outside a guided workflow, use the CLI reference. If a step fails, stop there and use Troubleshooting rather than skipping a trust or integrity check — those checks are the reason the destructive steps later are safe.