# Midsummer

> Midsummer is the whole vertical for a Project: repositories, CI, Deploy, Database, Storage, Email and Domains, each a product of its own, run from one CLI (`midsummer`), one API and one MCP server.

Every page below is Markdown. `/llms-full.txt` holds all of them in one file.

## Get started

- [Introduction](/get-started/introduction.md): What Midsummer is, what it runs for your project, and where to start.
- [Install and sign in](/get-started/sign-in.md): Install the CLI and Sol, sign in, and create a team and a repository.
- [Ship a project](/get-started/ship-a-project.md): Put a page live at its own address, then try a change on a preview and promote it to production.
- [Add a database](/get-started/add-a-database.md): Give your site a database. Write a schema and two functions, deploy them and call them.
- [Run CI](/get-started/run-ci.md): Add a workflow, push it, and watch it run.
- [How Midsummer fits together](/get-started/how-midsummer-fits.md): Teams, repositories, projects, environments, deployments and agents, and how they connect.
- [Ghost](/get-started/ghost.md): The Rust engine that Midsummer Database, Vector DB and Storage run on.
- [Use with agents](/get-started/use-with-agents.md): Connect a coding agent to Midsummer over MCP, so it can do anything you can.

## Guides

- [Guides](/guides.md): How to do one thing with each product, from start to finish.
- [Frameworks](/guides/frameworks/overview.md): Which frameworks and languages Midsummer builds, and how it recognises yours.
- [Orbit](/guides/orbit/overview.md): Where your team's code lives, with a workspace for every task, merge requests, issues and releases.
- [Create a repository](/guides/orbit/create-a-repository.md): Create a repository for your team, clone it, and restore one you deleted.
- [Next.js](/guides/frameworks/nextjs.md): Ship a Next.js app. Server rendering, incremental static regeneration, middleware and images work with no setup.
- [Astro](/guides/frameworks/astro.md): Ship an Astro site or app, static or server-rendered.
- [Work in views](/guides/orbit/work-in-views.md): Do each task in its own view, then review and merge it with a merge request.
- [SvelteKit](/guides/frameworks/sveltekit.md): Ship a SvelteKit app with its server.
- [Track issues](/guides/orbit/issues.md): Track bugs and tasks as issues, and start work on one in a view that closes it when it merges.
- [Cut a release](/guides/orbit/releases.md): Cut a signed release from a branch or a checkpoint, and list your releases.
- [Nuxt and Nitro](/guides/frameworks/nuxt.md): Ship Nuxt, SolidStart, Analog or any Nitro app.
- [Collaborators and forks](/guides/orbit/collaborators-and-forks.md): Give someone outside your team access to one repository, and fork a repository into another team.
- [TanStack Start](/guides/frameworks/tanstack-start.md): Ship a TanStack Start app, with React or Solid.
- [React Router and Remix](/guides/frameworks/react-router.md): Ship a React Router 7 app, or Remix 2 on Vite.
- [Angular](/guides/frameworks/angular.md): Ship an Angular app as files, or with its server from Angular 19.
- [Qwik City](/guides/frameworks/qwik.md): Ship a Qwik City app.
- [Node servers](/guides/frameworks/node-servers.md): Ship a server written with Hono, Express or Koa.
- [Vite and static sites](/guides/frameworks/static-sites.md): Ship a single-page app or a static site built with Vite or another npm tool.
- [Site generators](/guides/frameworks/site-generators.md): Ship a site built with Hugo, Zola, Jekyll or Middleman.
- [Rust and Go](/guides/frameworks/rust-and-go.md): Ship a Rust crate or a Go module that handles your site's requests.
- [Limits](/guides/orbit/limits.md): How long deleted repositories are kept, and what forks and Git clones leave out.
- [CI](/guides/ci/overview.md): Run shell scripts from your repository on every push, merge request or schedule, on hosted computers or your own.
- [Write workflows](/guides/ci/write-workflows.md): Write a workflow as a shell script in .ci/, and set when, where and how long it runs.
- [Run workflows](/guides/ci/run-workflows.md): Start a workflow by hand, follow it, and cancel a run you don't need.
- [Run on your own machines](/guides/ci/machines.md): Run your team's CI on your own computers, for free, and choose where runs go.
- [Cap spending and keep artifacts](/guides/ci/budgets-and-artifacts.md): Cap what a repository spends on CI each month, choose how long run artifacts are kept, and see its usage.
- [Keep your existing CI](/guides/ci/connect-outside-ci.md): Keep running on GitHub Actions, Buildkite, CircleCI and others, and start their runs from Midsummer.
- [Limits](/guides/ci/limits.md): How long a run can take, and what's free.
- [Projects](/guides/projects/overview.md): A project is what your team ships, from a folder or from one of your repositories.
- [Create a project](/guides/projects/create-a-project.md): Create a project, list your team's projects, and delete or restore one.
- [Build from a repository](/guides/projects/choose-the-code-source.md): Have a project build one of your repositories, or one folder of it, on every push.
- [Deployments](/guides/deploy/overview.md): Ship your project, try every change on its own preview, and promote the ones you like to production.
- [Ship your project](/guides/deploy/ship.md): Ship to production or to a preview, see a build's logs, and list your deployments.
- [Promote and roll back](/guides/deploy/promote-and-roll-back.md): Put a deployment live in production, and go back if something's wrong.
- [Build on your computer](/guides/deploy/build-locally.md): Build your project on your computer, ship that build as it is, or run it locally the way production would.
- [Limits](/guides/deploy/limits.md): What promotion rebuilds, what local builds can do, and what forks get.
- [Environments](/guides/environments/overview.md): Preview and production, and the variables, secrets and rules each one has.
- [Set variables and secrets](/guides/environments/variables-and-secrets.md): Give your code the values it needs, for every environment or for one.
- [Secrets your code never holds](/guides/environments/secrets-your-code-never-holds.md): Bind a secret to the hosts it's for, so your code, builds and agents only ever see a placeholder.
- [Choose branches and require approval](/guides/environments/branches-and-approval.md): Choose which branches deploy to an environment, make a reviewer approve each build, and choose who may approve and which CI runs get secrets.
- [Rotate secrets](/guides/environments/rotate-secrets.md): Let Midsummer generate a secret, then rotate it without breaking anything that uses it.
- [Limits](/guides/environments/limits.md): How long deleted values are kept, and what you can read back.
- [Domains](/guides/domains/overview.md): Register a domain or bring one you have, and use it for your projects and email.
- [Register a domain](/guides/domains/register-a-domain.md): Find an available name, get a price, and register it.
- [Connect a domain you have](/guides/domains/connect-a-domain.md): Use a domain you registered elsewhere, keeping its DNS with your current provider.
- [Manage DNS records](/guides/domains/dns-records.md): List and add DNS records for a domain you registered through Midsummer.
- [Serve a project at your domain](/guides/domains/serve-a-site.md): Serve your project at your own domain, such as www.acme.com.
- [Database](/guides/database/overview.md): Store your app's data, write the functions that read and change it in TypeScript, and give every view its own copy.
- [Develop locally](/guides/database/develop-locally.md): Run your database functions on your computer while you write them.
- [Deploy your db/ folder](/guides/database/deploy.md): Create a database, deploy your db/ folder to it, and roll back a deploy.
- [Use it from your code](/guides/database/call-functions.md): Bind a database in each environment, call it from your code or the terminal, and see who read production data.
- [Copy with masked data](/guides/database/branch-with-masked-data.md): Give a view or an agent its own copy of your database, with sensitive columns rewritten.
- [Connect from outside Midsummer](/guides/database/keys.md): Give code that runs elsewhere a database key, and connect with the SDK.
- [Save and restore](/guides/database/restore-points.md): Save your database before a risky change, go back to it, and restore a database you deleted.
- [Limits](/guides/database/limits.md): How far back you can copy, how long deleted databases are kept, and who can read production data.
- [Storage](/guides/storage/overview.md): Store your team's files in buckets, and reach them from your code or any S3 tool.
- [Create a bucket](/guides/storage/buckets.md): Create a bucket for your team's files, bind it in each environment, and list your buckets.
- [Use the SDK](/guides/storage/use-the-sdk.md): Read and write files in your buckets from your project's code.
- [Use S3 tools](/guides/storage/use-s3-tools.md): Use the AWS CLI, or any S3 tool, with your buckets.
- [Limits](/guides/storage/limits.md): Bucket names, deleting buckets, and how fast a revoked key stops working.
- [Vector DB](/guides/vector-db/overview.md): Store embeddings and find the ones most like a query, such as similar documents.
- [Create a namespace](/guides/vector-db/namespaces.md): Create a namespace with its dimension and metric, list your namespaces, and delete or restore one.
- [Store and query vectors](/guides/vector-db/store-and-query.md): Store vectors with metadata, find the closest to a query, fetch them by ID, and remove them.
- [Choose a region](/guides/vector-db/regions.md): Put a namespace near where you write from, and run queries near where they're asked.
- [Limits](/guides/vector-db/limits.md): What you can't change on a namespace, who can read production vectors, and how long deleted namespaces are kept.
- [Queues](/guides/queues/overview.md): Hand work off to do later, with retries, delays and schedules.
- [Send messages](/guides/queues/send-messages.md): Create a queue, bind it, send a message to it, and list your queues and their messages.
- [Push messages to an endpoint](/guides/queues/consumers.md): Have a queue push its messages to an HTTPS endpoint, check each delivery, and see the ones that failed.
- [Send messages on a schedule](/guides/queues/schedules.md): Send a message to a queue at the times a cron expression sets, and delete or restore a schedule.
- [Limits](/guides/queues/limits.md): Delays, duplicate sends, retries and restores.
- [Email](/guides/email/overview.md): Send your project's email from your own domain, and receive mail your code can read.
- [Add a sending domain](/guides/email/sending-domains.md): Add a domain to send from, publish its DNS records, and check it.
- [Send email](/guides/email/send-email.md): Send a message from the CLI or your deployment, give outside code an email key, and see suppressed addresses.
- [Receive mail](/guides/email/receive-mail.md): Create an inbox at an address on your domain, publish its records, and read its threads.
- [Get delivery events](/guides/email/webhooks.md): Have Midsummer post delivery events, such as bounces, to a URL of yours.
- [Agent OS](/guides/agent-os/overview.md): Run your own AI agents on Midsummer, with versions, schedules, memory and a record of every step.
- [Create an agent](/guides/agent-os/create-an-agent.md): Create an agent from a template, add versions, and choose which version each environment runs.
- [Run an agent](/guides/agent-os/run-an-agent.md): Run an agent by hand, on a schedule or from a webhook, and see what each run did.
- [Use memory and evaluations](/guides/agent-os/memory-and-evaluations.md): Keep values between runs, and score a version against test cases before you deploy it.
- [Teams](/guides/teams/overview.md): Bring people into your team, give each one a role, and add agents that work alongside you.
- [Create a team and invite people](/guides/teams/invite-people.md): Create a team, invite people to it with a role, and accept an invitation.
- [Choose roles](/guides/teams/roles.md): The standard roles, how to change a member's role, and how to create your own.
- [Add a team agent](/guides/teams/team-agents.md): Add an agent to your team that people @mention in issues and merge requests.
- [See the audit log](/guides/teams/audit-log.md): See who changed what in your team, and sign everyone out after a leak.
- [Manage sign-ins and tokens](/guides/identity/sign-in-and-tokens.md): See where you're signed in, sign one place out, turn on two-factor, and create personal tokens for scripts.
- [Usage and billing](/guides/usage/overview.md): What your team pays: a plan each month, credits for use beyond it, and a budget so there are no surprises.
- [Pay for your plan and credits](/guides/usage/billing.md): Choose a plan, buy credits, buy more automatically when they run low, and read your invoices, refunds and VAT.
- [Set a budget](/guides/usage/budgets.md): See what your team spends, cap what a billing cycle can spend, and choose what happens at the cap.
- [Notifications](/guides/notifications/notifications.md): See how your runs and deployments ended and what waits on you, and choose what reaches your email.
- [Use Git](/guides/git/use-git.md): Clone, fetch and push with Git and Git-only tools, and open a merge request from a pushed branch.
- [Link GitHub](/guides/github/link-github.md): Keep a repository in sync with a GitHub repository, both ways, as changes happen.
- [Scan a repository](/guides/security/scan-a-repository.md): Find leaked secrets, vulnerable dependencies and files that should be sealed, and resolve what a scan finds.
- [Builder](/guides/builder/overview.md): Describe an app and Builder makes it, ships every change as a preview, and keeps every version.
- [Build from a prompt](/guides/builder/build-from-a-prompt.md): Make a project from a prompt, change it with more prompts, and go back to any earlier version.
- [AI Gateway](/guides/ai-gateway/overview.md): Call AI models with one key for your whole team, billed in credits.
- [Call a model](/guides/ai-gateway/call-a-model.md): List the models and their prices, and call one from the terminal.
- [Create keys and see usage](/guides/ai-gateway/keys-and-usage.md): Give your code an AI key, and see what your team's calls cost.
- [Limits](/guides/ai-gateway/limits.md): Response length, temperature, and how retries with an idempotency key behave.

## Concepts

- [Teams](/concepts/teams.md): Who owns your work, who's in it, and what each person can do.
- [Repositories](/concepts/repositories.md): Where your code and its history live.
- [Views](/concepts/views.md): A separate workspace for each task, saved as you go.
- [Merge requests](/concepts/merge-requests.md): How a change is reviewed and merged, and what a repository can require first.
- [Projects](/concepts/projects.md): The site, app or agents your team ships.
- [Default domains](/concepts/default-domains.md): Your project's address on midsummer.sh, made from its name and your team's.
- [Deployments](/concepts/deployments.md): One build of your project, and how it goes live.
- [Environments](/concepts/environments.md): Where your code runs, such as preview and production, and the variables and secrets it gets.
- [Sealing](/concepts/sealing.md): Keep files in a repository that only the people you choose can read.
- [Machines](/concepts/machines.md): Run your team's CI and builds on your own computers, for free.
- [Agents](/concepts/agents.md): The three kinds of agent in Midsummer, and what each one can do.

## Reference

- [Reference](/reference.md): Every command, request and MCP call, by product, and the SDK your code imports.
- [Orbit reference](/reference/products/orbit.md): Every Orbit command, with its HTTP request and MCP call.
- [issue close](/reference/issue.close.md): Close an issue or discussion.
- [issue comment](/reference/issue.comment.md): Comment on an issue; who it @mentions, its author and its assignees are notified.
- [issue create](/reference/issue.create.md): Open an issue or a discussion; the Members and Team agents it @mentions are notified.
- [issue edit](/reference/issue.edit.md): Change an issue's title or body, or add and remove its labels and assignees.
- [issue link](/reference/issue.link.md): Link an issue to a merge request or a View, which closes it on merge unless you say --closes false.
- [issue list](/reference/issue.list.md): List a repository's issues and discussions, newest first: open ones unless you say.
- [issue reopen](/reference/issue.reopen.md): Reopen a closed issue or discussion.
- [issue show](/reference/issue.show.md): Show an issue with its comments, what happened to it and the merge requests and Views linked to it.
- [issue start](/reference/issue.start.md): Start a View to work on an issue: it is linked to close the issue, which you take when nobody has it.
- [issue unlink](/reference/issue.unlink.md): Take a merge request or View off an issue.
- [mr change list](/reference/mr.change.list.md): Show what a merge request changes; --since-review, what changed since your last review.
- [mr close](/reference/mr.close.md): Close a merge request without merging it.
- [mr comment apply](/reference/mr.comment.apply.md): Apply the changes comments suggest to the merge request's View.
- [mr comment create](/reference/mr.comment.create.md): Comment on a merge request, or on one line of a file it changes.
- [mr comment resolve](/reference/mr.comment.resolve.md): Mark a merge request's comment resolved.
- [mr conflict list](/reference/mr.conflict.list.md): Show the files a merge request conflicts on, with the base, the View and the target.
- [mr conflict resolve](/reference/mr.conflict.resolve.md): Resolve a merge request's conflicts: each file's text, or the View's or the target's side.
- [mr merge](/reference/mr.merge.md): Merge the whole proposal on Orbit under the repository's merge rules, with a release when named.
- [mr open](/reference/mr.open.md): Open a merge request from a View; the host reviews its change.
- [mr reopen](/reference/mr.reopen.md): Reopen a closed merge request.
- [mr review comment create](/reference/mr.review.comment.create.md): Add a comment to your pending review, sent when you review.
- [mr review comment delete](/reference/mr.review.comment.delete.md): Take a comment out of your pending review.
- [mr review create](/reference/mr.review.create.md): Review a merge request: approve, request changes or comment, sending your pending review's comments with it.
- [mr review delete](/reference/mr.review.delete.md): Discard your pending review and its comments.
- [mr reviewer add](/reference/mr.reviewer.add.md): Ask people or Team agents to review a merge request.
- [mr show](/reference/mr.show.md): Show a merge request, its checks and reviews.
- [release create](/reference/release.create.md): Cut a signed release from a branch's head or one of its checkpoints, with notes, to an audience first if asked.
- [release delete](/reference/release.delete.md): Delete a release; it can be restored for seven days and its name stays taken.
- [release edit](/reference/release.edit.md): Change a release's notes, or who sees it before its reveal time.
- [release list](/reference/release.list.md): List a repository's releases.
- [release restore](/reference/release.restore.md): Bring back a release deleted in the last seven days.
- [release show](/reference/release.show.md): Show a release, its notes and the merge requests it brought in.
- [repo activity list](/reference/repo.activity.list.md): What happened in a repository, newest first; --after waits for what happens after a cursor.
- [repo audit list](/reference/repo.audit.list.md): Who forked a repository, proposed to it or synced it, and when.
- [repo blame](/reference/repo.blame.md): Show who last changed each line of a file.
- [repo checkpoint create](/reference/repo.checkpoint.create.md): Save files, edits, deletions and renames to a View as one checkpoint.
- [repo checkpoint list](/reference/repo.checkpoint.list.md): List a branch's Checkpoints.
- [repo checkpoint show](/reference/repo.checkpoint.show.md): Show what one Checkpoint changed.
- [repo collaborator list](/reference/repo.collaborator.list.md): List the people given a role on this repository.
- [repo collaborator set](/reference/repo.collaborator.set.md): Give someone a role on this repository, or take it away with null.
- [repo compare](/reference/repo.compare.md): Show what changed between two branches, checkpoints or releases.
- [repo contributor list](/reference/repo.contributor.list.md): List who made a branch's checkpoints, with each one's share.
- [repo create](/reference/repo.create.md): Create a repository.
- [repo delete](/reference/repo.delete.md): Delete a repository: its code, history, Views and merge requests become inaccessible at once and can be restored for seven days.
- [repo detach](/reference/repo.detach.md): Make a fork of a public repository a repository of its own.
- [repo edit](/reference/repo.edit.md): Rename a repository, describe it, set its topics, change who can see it, or archive it.
- [repo embargo list](/reference/repo.embargo.list.md): List the embargoes in force that you are in.
- [repo embargo reveal](/reference/repo.embargo.reveal.md): End an embargo now: once merged everyone reads it, and before, the merge request is no longer embargoed.
- [repo embargo set](/reference/repo.embargo.set.md): Embargo a merge request for chosen Members until its reveal, or change who or when before it merges.
- [repo file change list](/reference/repo.file.change.list.md): List the checkpoints that changed a file, each with its diff.
- [repo file list](/reference/repo.file.list.md): List the files on a branch, or as they were at one of its checkpoints.
- [repo file show](/reference/repo.file.show.md): Read one file on a branch, or as it was at one of its checkpoints.
- [repo forget](/reference/repo.forget.md): End a deleted repository's seven days now: it can no longer be restored, and it and what every product keeps for it are forgotten for good.
- [repo fork](/reference/repo.fork.md): Fork a repository into a Team you may create repositories in, with every branch you can read and its history.
- [repo fork list](/reference/repo.fork.list.md): List a repository's forks.
- [repo fork set](/reference/repo.fork.set.md): Keep a fork's default branch up with its original's while it has nothing of its own, or stop.
- [repo insights show](/reference/repo.insights.show.md): Show a branch's checkpoints and merged requests by day, and its contributors' shares.
- [repo list](/reference/repo.list.md): List a Team's repositories; --deleted lists those deleted in the last seven days, while they can be restored.
- [repo network show](/reference/repo.network.show.md): A repository's fork family: its topmost original and every fork below it, each with how far it is ahead and behind.
- [repo propose](/reference/repo.propose.md): Propose a fork's branch to the repository it was forked from, or bring its open request up to the branch.
- [repo read](/reference/repo.read.md): Read several files on a branch at once, at its head or at a snapshot.
- [repo remote show](/reference/repo.remote.show.md): Show the Team and repository a Sol remote names, to someone who may read it.
- [repo restore](/reference/repo.restore.md): Bring back a deleted repository as it was: its content, settings, collaborators and stars.
- [repo restrict](/reference/repo.restrict.md): Keep a View, or a merge request and its View, to chosen Members, or change who.
- [repo restriction list](/reference/repo.restriction.list.md): List the Views and merge requests only some people may read.
- [repo search](/reference/repo.search.md): Search a branch's code for text.
- [repo settings set](/reference/repo.settings.set.md): Set a repository's merge rules.
- [repo show](/reference/repo.show.md): Show a repository: its branches, merge requests and clone URL.
- [repo star](/reference/repo.star.md): Star a repository, or take the star back.
- [repo sync](/reference/repo.sync.md): Bring a fork's branch up to its original: it moves forward, or the original's changes arrive as a merge request in the fork.
- [repo transfer](/reference/repo.transfer.md): Move a repository to another Team you manage.
- [repo unrestrict](/reference/repo.unrestrict.md): Open a restricted View to everyone with access.
- [repo watch](/reference/repo.watch.md): Watch a repository, or stop watching it.
- [view change list](/reference/view.change.list.md): Show what a View changes.
- [view create](/reference/view.create.md): Start a View from a branch, with nothing changed yet.
- [view delete](/reference/view.delete.md): Delete a View; the default branch is never one.
- [view list](/reference/view.list.md): List the Views landing on the base, each with its last save, what it changes, how far it is ahead and behind, and its merge request; --deleted lists deleted ones, each at the head it had.
- [view restore](/reference/view.restore.md): Bring back a deleted View at the head it had.
- [CI reference](/reference/products/ci.md): Every CI command, with its HTTP request and MCP call.
- [ci artifact download](/reference/ci.artifact.download.md): Download a file a Run kept.
- [ci artifact expire](/reference/ci.artifact.expire.md): Remove the files a Run kept, before they expire.
- [ci artifact list](/reference/ci.artifact.list.md): List the files a Run kept.
- [ci audit list](/reference/ci.audit.list.md): Who changed CI settings, and when.
- [ci connection add](/reference/ci.connection.add.md): Connect an outside CI provider; shows its token and signing secret once.
- [ci connection artifact list](/reference/ci.connection.artifact.list.md): List the files a connected provider's run kept.
- [ci connection edit](/reference/ci.connection.edit.md): Change a connection's organization, project, pipeline, address or provider API token.
- [ci connection list](/reference/ci.connection.list.md): List a repository's connections to outside CI providers.
- [ci connection remove](/reference/ci.connection.remove.md): Disconnect an outside CI provider.
- [ci connection replay](/reference/ci.connection.replay.md): Send a connection's last event again.
- [ci connection run approve](/reference/ci.connection.run.approve.md): Approve what a connected provider's run waits on, such as a gated environment or a block step.
- [ci connection run cancel](/reference/ci.connection.run.cancel.md): Cancel a connected provider's run.
- [ci connection run list](/reference/ci.connection.run.list.md): List a connected provider's recent runs through its API.
- [ci connection run logs](/reference/ci.connection.run.logs.md): Read a connected provider's run output.
- [ci connection run retry](/reference/ci.connection.run.retry.md): Retry a connected provider's run.
- [ci connection run start](/reference/ci.connection.run.start.md): Start a connected provider's run for a merge request's candidate.
- [ci connection test](/reference/ci.connection.test.md): Send a signed ping to a connection.
- [ci migration show](/reference/ci.migration.show.md): The repository's GitHub Actions workflows turned into Midsummer CI workflows, with what does not carry over.
- [ci notification settings set](/reference/ci.notification.settings.set.md): Choose what you hear about from a repository's CI.
- [ci notification settings show](/reference/ci.notification.settings.show.md): What you hear about from a repository's CI.
- [ci policy set](/reference/ci.policy.set.md): Set who approves runs, the monthly budget and how long artifacts stay.
- [ci policy show](/reference/ci.policy.show.md): How a repository's runs are governed.
- [ci run approve](/reference/ci.run.approve.md): Approve a Run waiting for approval.
- [ci run cancel](/reference/ci.run.cancel.md): Cancel a Run.
- [ci run filter delete](/reference/ci.run.filter.delete.md): Remove a Run filter you saved.
- [ci run filter list](/reference/ci.run.filter.list.md): List the Run filters you saved.
- [ci run filter set](/reference/ci.run.filter.set.md): Save a Run filter by name, replacing one of that name; use it with ci run list --filter <name>.
- [ci run list](/reference/ci.run.list.md): List Runs, newest first; --filter <name> applies a Run filter you saved, --before <number> lists older ones.
- [ci run reject](/reference/ci.run.reject.md): Reject a Run waiting for approval.
- [ci run show](/reference/ci.run.show.md): Show a Run and its output; --follow prints its output live until it ends.
- [ci run start](/reference/ci.run.start.md): Start a Workflow; --follow prints its output live until it ends.
- [ci usage show](/reference/ci.usage.show.md): How much CI a repository used.
- [ci workflow list](/reference/ci.workflow.list.md): List a branch's Workflows.
- [ci workflow set](/reference/ci.workflow.set.md): Pause a workflow or resume it.
- [machine add](/reference/machine.add.md): Register a machine for the Team's jobs, or with --repository for one repository's; shows its token once (`midsummer runner` does this).
- [machine edit](/reference/machine.edit.md): Change how many jobs a machine takes at once, or drain it.
- [machine list](/reference/machine.list.md): List the Team's own machines and where its jobs go; --repository, the hosted machines and the repository's own.
- [machine remove](/reference/machine.remove.md): Remove one of the Team's machines, or with --repository one of the repository's.
- [machine route set](/reference/machine.route.set.md): Choose where the Team's CI Runs and Deploy builds execute: hosted, its Machines first, or its Machines only.
- [Projects reference](/reference/products/projects.md): Every Projects command, with its HTTP request and MCP call.
- [project create](/reference/project.create.md): Make a Project, named uniquely in its Team: given one of the Team's repositories it builds each push to it, from a folder of it when given that; without one it ships from folders.
- [project delete](/reference/project.delete.md): Delete a Project: its addresses stop answering, and it can be restored as it was for seven days, then it and what every product keeps for it go.
- [project forget](/reference/project.forget.md): End a deleted Project's seven days now: it can no longer be restored, and what every product keeps for it is forgotten for good.
- [project list](/reference/project.list.md): List a Team's Projects and the repository and folder each builds; --deleted lists those deleted in the last seven days, while they can be restored.
- [project repository remove](/reference/project.repository.remove.md): Stop a Project building a repository: it ships from folders.
- [project repository set](/reference/project.repository.set.md): Have a Project build one of its Team's repositories, from a folder of it when given one.
- [project restore](/reference/project.restore.md): Bring back a deleted Project as it was, its addresses answering again.
- [project show](/reference/project.show.md): Show a Project: its id, its source setting, and the repository and folder it builds, when it builds one.
- [project source show](/reference/project.source.show.md): Where the Project's code comes from: sol when it builds a repository, folder when it ships only from folders.
- [Deploy reference](/reference/products/deploy.md): Every Deploy command, with its HTTP request and MCP call.
- [deploy analytics](/reference/deploy.analytics.md): A Project's requests, server errors and latency by the hour, in total and by Deployment, over the last --hours (up to 168).
- [deploy app-domain show](/reference/deploy.app-domain.show.md): Show the origin of the app domain, where every Project's default domain is.
- [deploy approve](/reference/deploy.approve.md): Approve a build waiting on its Environment, which then builds.
- [deploy cancel](/reference/deploy.cancel.md): Stop a Deployment's build, before or while it runs.
- [deploy create](/reference/deploy.create.md): Ship a Deployment: a branch's head or the Checkpoint named, files uploaded by SHA-256, or a prebuilt archive; promoted to an Environment once Ready when asked.
- [deploy default-domain set](/reference/deploy.default-domain.set.md): Rename the Project's default domain; every address moves, and the old ones stop.
- [deploy default-domain show](/reference/deploy.default-domain.show.md): The Project's default domain on the app domain, <project>-<team>, made by its first Deployment.
- [deploy domain add](/reference/deploy.domain.add.md): Attach a name to the Project, serving an Environment (production by default) once its DNS points at the Project's default domain and its certificate is issued; a name under none of the Team's Domains joins the Team. Shows the DNS records it needs.
- [deploy domain check](/reference/deploy.domain.check.md): Check an attached name's DNS and certificate now; it serves as soon as both hold.
- [deploy domain list](/reference/deploy.domain.list.md): List the names of the Team's Domains attached to the Project, with what each waits on.
- [deploy domain remove](/reference/deploy.domain.remove.md): Detach a name from the Project: it stops serving at once, and its certificate and the DNS attaching pointed are let go.
- [deploy drain add](/reference/deploy.drain.add.md): Send what an Environment's Deployment prints to an HTTPS endpoint, signed; shows the signing secret once.
- [deploy drain list](/reference/deploy.drain.list.md): List the Project's log drains, and how each one's delivery stands.
- [deploy drain remove](/reference/deploy.drain.remove.md): Stop sending a Project's runtime logs to a drain.
- [deploy environment list](/reference/deploy.environment.list.md): What each Environment serves, and where.
- [deploy file list](/reference/deploy.file.list.md): Which of these files, by SHA-256, the Project does not have yet: what an upload still has to send.
- [deploy list](/reference/deploy.list.md): List Deployments, newest first.
- [deploy logs](/reference/deploy.logs.md): A Deployment's build log; --follow prints it live until it ends.
- [deploy project start](/reference/deploy.project.start.md): Make the Project of a repository's name, building it, for its first ship; safe to repeat once it exists.
- [deploy promote](/reference/deploy.promote.md): Point an Environment at a Ready Deployment; one built with another Environment's values is built again with this one's and promoted once Ready, except prebuilt output, which is refused.
- [deploy reject](/reference/deploy.reject.md): Reject a build waiting on its Environment, which cancels it.
- [deploy republish](/reference/deploy.republish.md): Publish again a Project unpublished in the last seven days, serving what it served.
- [deploy rollback](/reference/deploy.rollback.md): Promote the Deployment an Environment served before.
- [deploy runtime-log list](/reference/deploy.runtime-log.list.md): What a Deployment printed as it ran, from --since ago (an hour when not given); --follow prints it live.
- [deploy schedule list](/reference/deploy.schedule.list.md): List the Schedules production's Deployment declares, with when each runs next and how it last ran.
- [deploy schedule runs](/reference/deploy.schedule.runs.md): List a Project's Schedule runs, newest first, kept seven days.
- [deploy show](/reference/deploy.show.md): Show a Deployment, by id or number.
- [deploy unpublish](/reference/deploy.unpublish.md): Unpublish the Project: its addresses stop answering, and its Deployments are kept seven days, restorable.
- [Environments reference](/reference/products/environments.md): Every Environments command, with its HTTP request and MCP call.
- [env apply](/reference/env.apply.md): Make the values midsummer.json declares and nothing has set yet, and say what still needs you.
- [env audit list](/reference/env.audit.list.md): Who changed a Project's Environments and values, and when.
- [env binding list](/reference/env.binding.list.md): List what a Project's Environments bind, by Environment and name.
- [env binding remove](/reference/env.binding.remove.md): Remove a binding from an Environment.
- [env binding set](/reference/env.binding.set.md): Bind a resource of the Project's Team in an Environment under a name, replacing what the name bound there.
- [env delete](/reference/env.delete.md): Delete one value, restorable for seven days; --environment '*' selects the shared value, leaving Environment-specific overrides unchanged.
- [env dev end](/reference/env.dev.end.md): End a midsummer dev session early; the running midsummer dev ends its own session when it exits.
- [env dev start](/reference/env.dev.start.md): Run code on your computer in an Environment: its values, placeholders for secrets bound to hosts, and an identity token.
- [env edit](/reference/env.edit.md): Say what a value is for, or with null stop saying it, without changing the value.
- [env environment delete](/reference/env.environment.delete.md): Remove an Environment's rules; its values stay.
- [env environment list](/reference/env.environment.list.md): List a Project's Environments and their rules.
- [env environment set](/reference/env.environment.set.md): Set an Environment's rules: the branches that deploy to it, who approves, and which CI runs get its secrets bound to no hosts; rules left out keep what they were.
- [env identity set](/reference/env.identity.set.md): Set the audience workloads' identity tokens carry, or confirm a cloud trusts them.
- [env identity show](/reference/env.identity.show.md): The issuer, audience and subjects clouds trust a Project's workloads by.
- [env integration add](/reference/env.integration.add.md): Connect a service with a key that may make keys; it is checked, kept, and never shown again.
- [env integration list](/reference/env.integration.list.md): List the services a Team has connected.
- [env integration remove](/reference/env.integration.remove.md): Forget a connected service, once no secret made through it remains.
- [env key create](/reference/env.key.create.md): Have a connected service make a key and keep it as an Environment's secret, bound to the service's hosts.
- [env list](/reference/env.list.md): List the values a Project's Environments give, never a secret's; --deleted lists those deleted in the last seven days.
- [env move](/reference/env.move.md): Move a value to one Environment, or to every one; name the one it is in when it has more than one.
- [env restore](/reference/env.restore.md): Bring back a deleted value as it was, within seven days; --environment picks one Environment's, and '*' the shared value, leaving Environment-specific overrides unchanged.
- [env rotate](/reference/env.rotate.md): Rotate a generated secret, or one an Integration made: its next value now, the one before kept for the overlap, what uses it rebuilt.
- [env set](/reference/env.set.md): Set a value for one Environment, or every one: a variable, a secret, one Midsummer generates, or one kept in an outside store (--integration vault --path …).
- [env token create](/reference/env.token.create.md): Make a token that may only write this secret's next value, for something outside Midsummer that rotates it; shown once.
- [env token list](/reference/env.token.list.md): List the drop tokens that may write a Project's secrets.
- [env token revoke](/reference/env.token.revoke.md): End a drop token at once.
- [Domains reference](/reference/products/domains.md): Every Domains command, with its HTTP request and MCP call.
- [domain add](/reference/domain.add.md): Connect a Domain registered elsewhere, whose DNS stays where it is; attaching one of its names connects it too.
- [domain edit](/reference/domain.edit.md): Turn a Domain's auto-renew on or off, or set its DNSSEC DS records (none turns DNSSEC off).
- [domain list](/reference/domain.list.md): List the Team's Domains, or with --show deleted those removed in the last seven days, while they can be restored.
- [domain quote](/reference/domain.quote.md): Hold a price for five minutes, to register, renew or transfer a Domain.
- [domain record add](/reference/domain.record.add.md): Add a DNS record to a Domain registered here; name it @ for the Domain itself.
- [domain record list](/reference/domain.record.list.md): List a Domain's DNS records, or with --show deleted those removed in the last seven days, while they can be restored.
- [domain record remove](/reference/domain.record.remove.md): Remove a DNS record from a Domain registered here, restorable for seven days.
- [domain record restore](/reference/domain.record.restore.md): Add back a DNS record removed in the last seven days, as it was.
- [domain register](/reference/domain.register.md): Register a Domain for the Team at its quoted price.
- [domain remove](/reference/domain.remove.md): Remove a connected Domain, restorable for seven days; a registered one stays the Team's until it expires.
- [domain renew](/reference/domain.renew.md): Renew a Domain registered here at its quoted price.
- [domain restore](/reference/domain.restore.md): Bring back a Domain removed in the last seven days, as it was.
- [domain search](/reference/domain.search.md): Find names like this one to register, with their prices in US cents for the shortest term each is sold for.
- [domain show](/reference/domain.show.md): Show one of the Team's Domains.
- [domain transfer](/reference/domain.transfer.md): Move a Domain registered elsewhere here at its quoted price, with the code its registrar gives.
- [Database reference](/reference/products/database.md): Every Database command, with its HTTP request and MCP call.
- [db copy create](/reference/db.copy.create.md): Make a copy of this Database, with its rows as they are now or were at a time in the last 7 days; --masked rewrites the columns its mask names, and an agent's copy is always masked.
- [db create](/reference/db.create.md): Make an empty Database.
- [db data-use list](/reference/db.data-use.list.md): Who read production rows or ran functions by hand, and when.
- [db delete](/reference/db.delete.md): Delete a Database, restorable for 7 days, or at once with --now.
- [db deploy](/reference/db.deploy.md): Deploy the files of a db/ folder to this Database, made if the Team has none by that name; the CLI uploads ./db.
- [db deploy list](/reference/db.deploy.list.md): List a Database's deploys, newest first.
- [db key create](/reference/db.key.create.md): Make a key to this Database for code outside Midsummer; shows its secret once.
- [db key list](/reference/db.key.list.md): List this Database's keys, newest first, without their secrets.
- [db key revoke](/reference/db.key.revoke.md): Revoke a key: it gives no token again, so its access ends within 10 minutes.
- [db list](/reference/db.list.md): List a Team's Databases and branches.
- [db logs](/reference/db.logs.md): A Database's function logs, oldest first, from --since (the last hour) or --after a page's next.
- [db mask list](/reference/db.mask.list.md): List the columns this Database's mask rewrites in a masked branch, and how.
- [db mask remove](/reference/db.mask.remove.md): Stop masking a column in new masked branches; never an agent's to do.
- [db mask set](/reference/db.mask.set.md): Mask a column (table.field) in masked branches: redact, hash (joins still match) or fake; an agent may add a rule, never change one.
- [db metrics show](/reference/db.metrics.show.md): A Database's health over time: calls, errors, slowed and refused calls, and their times.
- [db restore](/reference/db.restore.md): Bring back a deleted Database before its rows are purged.
- [db restore-point create](/reference/db.restore-point.create.md): Keep this Database's rows as they are now, to restore later; sent again with a name, returns the first.
- [db restore-point list](/reference/db.restore-point.list.md): List this Database's restore points, newest first; one a replace took first names what it restored.
- [db restore-point restore](/reference/db.restore-point.restore.md): Restore a point into a new branch (--into, restore-<point> by default), or with --replace over this Database's rows after keeping a point of them; --tag makes a retry replace once.
- [db rollback](/reference/db.rollback.md): Serve the live deploy before the one this Database serves; rows stay as they are.
- [db row list](/reference/db.row.list.md): A page of a table's rows, by id or by an index; --after takes the last page's next.
- [db run](/reference/db.run.md): Run one of a Database's functions by hand, internal ones too, as the server or as a user.
- [db show](/reference/db.show.md): Show a Database: its address, what it was copied from and the deploy it serves.
- [db signing-key rotate](/reference/db.signing-key.rotate.md): Give this Database a new signing key; tokens of the old one work 11 minutes more.
- [db table list](/reference/db.table.list.md): List a Database's tables and their rows; production data needs production data access.
- [db token create](/reference/db.token.create.md): Exchange a Database Key, or a run's Workload token and a binding name, for a 10-minute token and the Database's address.
- [Storage reference](/reference/products/storage.md): Every Storage command, with its HTTP request and MCP call.
- [storage bucket create](/reference/storage.bucket.create.md): Make a Bucket in a Team, named uniquely there.
- [storage bucket delete](/reference/storage.bucket.delete.md): Delete a Bucket that holds no Objects and no Environment binds.
- [storage bucket list](/reference/storage.bucket.list.md): List a Team's Buckets.
- [storage key create](/reference/storage.key.create.md): Make a Storage Key for S3-protocol tools and code outside Midsummer; shows its secret once. Given a Project's Environment, it names Buckets by that Environment's bindings.
- [storage key list](/reference/storage.key.list.md): List a Team's Storage Keys, newest first, without their secrets.
- [storage key revoke](/reference/storage.key.revoke.md): Revoke a Storage Key: new requests and connections with it are refused, and an open SDK connection keeps its access until it renews, after a minute or 4,000 calls.
- [Vector DB reference](/reference/products/vector-db.md): Every Vector DB command, with its HTTP request and MCP call.
- [vector delete](/reference/vector.delete.md): Remove Vectors by id; ids not there are not an error.
- [vector fetch](/reference/vector.fetch.md): Read Vectors by id, with their values and metadata.
- [vector namespace create](/reference/vector.namespace.create.md): Make a Vector namespace in a Team, its dimension and metric fixed; made again the same way, returns the first.
- [vector namespace delete](/reference/vector.namespace.delete.md): Delete a Vector namespace no Environment binds, restorable for 7 days; its name is free at once.
- [vector namespace list](/reference/vector.namespace.list.md): List a Team's Vector namespaces, or with deleted, those still restorable.
- [vector namespace restore](/reference/vector.namespace.restore.md): Bring back the Vector namespace by this name deleted last, with its Vectors.
- [vector namespace show](/reference/vector.namespace.show.md): Show a Vector namespace: its dimension, metric and how many Vectors it holds.
- [vector query](/reference/vector.query.md): Find the Vectors closest to a vector, or to a text its model embeds, that match a metadata filter, closest first.
- [vector upsert](/reference/vector.upsert.md): Store Vectors in a namespace, replacing those with the same ids; those given as text are embedded by its model.
- [Queues reference](/reference/products/queues.md): Every Queues command, with its HTTP request and MCP call.
- [queue consumer remove](/reference/queue.consumer.remove.md): Stop delivering a Queue's Messages; they wait for code that binds the Queue to receive them.
- [queue consumer set](/reference/queue.consumer.set.md): Deliver a Queue's Messages to an HTTPS endpoint, signed, retrying failures, dead-lettering after maxAttempts; returns the secret the endpoint checks signatures with.
- [queue create](/reference/queue.create.md): Make a Queue in a Team, or answer the one by that name.
- [queue delete](/reference/queue.delete.md): Delete a Queue no Environment binds, with its Messages.
- [queue list](/reference/queue.list.md): List a Team's Queues with their depth, dead-letter count and oldest Message's age.
- [queue message create](/reference/queue.message.create.md): Send a Message to a Queue, made on first send; its key sent again within a day returns the first Message.
- [queue message list](/reference/queue.message.list.md): List a Queue's Messages, or with --dead its dead-letter Queue's, oldest first, without receiving them.
- [queue show](/reference/queue.show.md): Show a Queue: what it holds, how long the oldest Message has waited, and its Consumer.
- [schedule create](/reference/schedule.create.md): Make a Schedule that sends a Message to a Queue at the times its cron names, in UTC; its key sent again returns the first.
- [schedule delete](/reference/schedule.delete.md): Delete a Schedule; it sends nothing more, and can be restored for seven days.
- [schedule list](/reference/schedule.list.md): List a Team's Schedules and when each sends next; --deleted, those deleted that can be restored.
- [schedule restore](/reference/schedule.restore.md): Bring back a Schedule deleted in the last seven days.
- [Email reference](/reference/products/email.md): Every Email command, with its HTTP request and MCP call.
- [email domain add](/reference/email.domain.add.md): Make a name a Sending domain of the Team; a name under none of the Team's Domains joins the Team. Shows its DNS records, added here when Domains keeps its DNS. Safe to run again.
- [email domain check](/reference/email.domain.check.md): Check whether a Sending domain's DNS records answer, and verify it when they do.
- [email domain list](/reference/email.domain.list.md): List the Team's Sending domains and whether each is verified, with those removed in the last seven days.
- [email domain remove](/reference/email.domain.remove.md): Stop sending from a Sending domain and remove the DNS records added for it, restorable for seven days. Safe to run again.
- [email domain restore](/reference/email.domain.restore.md): Bring back a Sending domain removed in the last seven days, as it was, its DNS records added again.
- [email domain show](/reference/email.domain.show.md): Show a Sending domain with the DNS records it needs.
- [email draft create](/reference/email.draft.create.md): Start a Draft in an Inbox, or in reply in a Thread (--thread), which gives its recipients and subject; with --key, asking again returns that Draft, sent or deleted since.
- [email draft delete](/reference/email.draft.delete.md): Delete a Draft, restorable for seven days.
- [email draft edit](/reference/email.draft.edit.md): Change a Draft's recipients, subject or words.
- [email draft list](/reference/email.draft.list.md): List an Inbox's Drafts, newest first, or with --show deleted those deleted in the last seven days.
- [email draft restore](/reference/email.draft.restore.md): Bring back a Draft deleted in the last seven days.
- [email draft send](/reference/email.draft.send.md): Send a Draft from its Inbox: it joins its Thread; sending it again returns the message sent.
- [email draft show](/reference/email.draft.show.md): Show a Draft.
- [email inbox check](/reference/email.inbox.check.md): Look for an Inbox's DNS records; once both are set it is active and receives.
- [email inbox create](/reference/email.inbox.create.md): Make an Inbox at an address on a Domain the Team holds, pending until its DNS records are set and checked; --agent makes it an Agent inbox.
- [email inbox delete](/reference/email.inbox.delete.md): Delete an Inbox: it receives nothing more, and is restorable for seven days.
- [email inbox edit](/reference/email.inbox.edit.md): Rename an Inbox, or give it to an Agent (--agent), or to none (null).
- [email inbox list](/reference/email.inbox.list.md): List the Team's Inboxes, or with --show deleted those deleted in the last seven days.
- [email inbox restore](/reference/email.inbox.restore.md): Bring back an Inbox deleted in the last seven days, with its Threads, Drafts and Rules.
- [email inbox rule add](/reference/email.inbox.rule.add.md): Add a Rule: mail whose sender, recipients and subject contain what it says is labelled, posted to a webhook or handed to an Agent; shows the webhook's signing secret once.
- [email inbox rule list](/reference/email.inbox.rule.list.md): List an Inbox's Rules, in the order they run on what arrives, or with --show deleted those removed in the last seven days.
- [email inbox rule remove](/reference/email.inbox.rule.remove.md): Remove a Rule, restorable for seven days; webhooks it still owes are not posted.
- [email inbox rule restore](/reference/email.inbox.rule.restore.md): Bring back a Rule removed in the last seven days.
- [email inbox show](/reference/email.inbox.show.md): Show an Inbox, by id or address.
- [email key create](/reference/email.key.create.md): Make an Email key for the Team's code to send with, through the SDK or as an SMTP password; shows its secret, and with --key the same key however often it is asked.
- [email key list](/reference/email.key.list.md): List the Team's Email keys, newest first, without their secrets.
- [email key revoke](/reference/email.key.revoke.md): Revoke an Email key; its next send is refused.
- [email message list](/reference/email.message.list.md): List the Team's Messages of the last thirty days, newest first.
- [email message send](/reference/email.message.send.md): Send a Message from a verified Sending domain; suppressed recipients are left out. Reuse the key to retry while the original Message is retained for thirty days. After that Message is purged, the same key can send another Message.
- [email message show](/reference/email.message.show.md): Show a Message with each recipient's delivery and its delivery events.
- [email suppression add](/reference/email.suppression.add.md): Stop sending to an address.
- [email suppression list](/reference/email.suppression.list.md): List the addresses the Project no longer sends to: hard bounces, complaints, repeated soft bounces and those added by hand.
- [email suppression remove](/reference/email.suppression.remove.md): Send to a suppressed address again, its soft bounces counted from none.
- [email thread edit](/reference/email.thread.edit.md): Set a Thread's labels.
- [email thread list](/reference/email.thread.list.md): List an Inbox's Threads, last active first; --before <lastAt>:<id> of a page's last Thread for the page after.
- [email thread reply](/reference/email.thread.reply.md): Reply in a Thread at once, to whoever last wrote unless --to says; with --key, asking again returns the message sent.
- [email thread show](/reference/email.thread.show.md): Show a Thread with its messages, in order.
- [Agent OS reference](/reference/products/agent-os.md): Every Agent OS command, with its HTTP request and MCP call.
- [agent artifact list](/reference/agent.artifact.list.md): List the files a run kept.
- [agent artifact show](/reference/agent.artifact.show.md): Download a file a run kept.
- [agent create](/reference/agent.create.md): Make an Agent with its first version from a template, one file, and its Agent inbox; the same --key returns the same Agent.
- [agent delete](/reference/agent.delete.md): Delete an Agent: nothing starts its runs; restorable for seven days.
- [agent deployment list](/reference/agent.deployment.list.md): Which version each Environment runs, its Schedule and webhook.
- [agent deployment rollback](/reference/agent.deployment.rollback.md): Have an Environment run the version it ran before.
- [agent deployment set](/reference/agent.deployment.set.md): Have an Environment run a version.
- [agent evaluation create](/reference/agent.evaluation.create.md): Run a version on cases ([{input, expected}]) and score it; the same --key returns the same Evaluation.
- [agent evaluation list](/reference/agent.evaluation.list.md): An Agent's Evaluations, newest first, with each version's score.
- [agent evaluation show](/reference/agent.evaluation.show.md): Show an Evaluation: each case's run, whether it passed, and the score.
- [agent event list](/reference/agent.event.list.md): A run's events in order; --after takes the last sequence seen.
- [agent list](/reference/agent.list.md): List the Project's Agents, or with --deleted those still restorable.
- [agent memory delete](/reference/agent.memory.delete.md): Remove a key from an Agent's memory.
- [agent memory list](/reference/agent.memory.list.md): What an Agent keeps in an Environment's memory (production unless named).
- [agent memory set](/reference/agent.memory.set.md): Set a key of an Agent's memory to a JSON value.
- [agent restore](/reference/agent.restore.md): Bring back an Agent deleted in the last seven days.
- [agent run cancel](/reference/agent.run.cancel.md): End a run: its code's next call is refused.
- [agent run list](/reference/agent.run.list.md): List an Agent's runs, newest first.
- [agent run show](/reference/agent.run.show.md): Show a run: its status, input, output and what it spent.
- [agent run start](/reference/agent.run.start.md): Start a run on an Environment's version (production unless named) or --version; the same --key returns the same run.
- [agent schedule remove](/reference/agent.schedule.remove.md): Stop an Environment's Schedule.
- [agent schedule set](/reference/agent.schedule.set.md): Start a run at each time a cron names (UTC), such as "0 9 * * 1-5".
- [agent show](/reference/agent.show.md): Show an Agent: its newest version and what each Environment runs.
- [agent version create](/reference/agent.version.create.md): Make a version from a file (--source-file agent.ts) or a template; settings left out are the newest version's.
- [agent version list](/reference/agent.version.list.md): List an Agent's versions, newest first.
- [agent version show](/reference/agent.version.show.md): Show a version with its code; --json and .source give the file.
- [agent webhook create](/reference/agent.webhook.create.md): Give an Environment a webhook, ending any before; shows its URL and its secret once.
- [agent webhook remove](/reference/agent.webhook.remove.md): Remove an Environment's webhook: its posts are refused.
- [Teams reference](/reference/products/teams.md): Every Teams command, with its HTTP request and MCP call.
- [team agent add](/reference/team.agent.add.md): Add an agent to a Team: run by Midsummer, or connected from outside (Claude, a bot) through a sign-in.
- [team agent edit](/reference/team.agent.edit.md): Change what sets an agent to work, its Schedule and instructions, or pause it.
- [team agent list](/reference/team.agent.list.md): List a Team's agents.
- [team agent remove](/reference/team.agent.remove.md): Remove an agent from a Team: its sign-ins end, and its work keeps its name.
- [team agent run list](/reference/team.agent.run.list.md): List a Team agent's runs, the latest first: what set it to work, where, and what it replied.
- [team agent sign-in create](/reference/team.agent.sign-in.create.md): Sign an agent in for whatever runs it outside Midsummer; shows its credential once.
- [team agent sign-in list](/reference/team.agent.sign-in.list.md): List an agent's sign-ins in a Team, the latest first.
- [team agent sign-in revoke](/reference/team.agent.sign-in.revoke.md): End one of an agent's sign-ins: its credentials stop working at once.
- [team agent sign-in rotate](/reference/team.agent.sign-in.rotate.md): Replace an agent's sign-in with a new one and a new credential, shown once; the old one works an hour more.
- [team app create](/reference/team.app.create.md): Register an App that signs people in with OAuth and acts for them within the scopes it may be granted; shows its secret once.
- [team app delete](/reference/team.app.delete.md): Delete an App: every sign-in it was given ends at once.
- [team app edit](/reference/team.app.edit.md): Change an App's name, description, homepage, return addresses or the scopes it may be granted; sign-ins it was given keep what they were granted.
- [team app list](/reference/team.app.list.md): List a Team's Apps.
- [team app rotate](/reference/team.app.rotate.md): Give an App a new secret, shown once; the one before keeps working an hour.
- [team app show](/reference/team.app.show.md): Show one of a Team's Apps.
- [team audit export](/reference/team.audit.export.md): Download the Team's audit log as JSON lines, oldest first: --since a date or time back (a year when left out), --until a date, --after the next an earlier export returned.
- [team audit list](/reference/team.audit.list.md): List who changed what in a Team, from which sign-in, the latest first: --since 7d or a date, --actor a handle, --action a key or its group.
- [team create](/reference/team.create.md): Create a Team.
- [team delete](/reference/team.delete.md): Delete a Team: it and everything it owns are out of reach at once, and its owners can restore it for seven days.
- [team directory delete](/reference/team.directory.delete.md): Disconnect the Team's Directory; the Members it made stay Members.
- [team directory set](/reference/team.directory.set.md): Keep the Team's Members in your company's Directory: whoever it provisions joins with the role, whoever it deprovisions leaves; returns the link your IT admin connects it with.
- [team directory show](/reference/team.directory.show.md): Show the Team's Directory: its role, its state, when it last synced and a fresh setup link.
- [team directory sync](/reference/team.directory.sync.md): Apply the Directory's changes now, as happens every five minutes: who joined and who left.
- [team forget](/reference/team.forget.md): End a deleted Team's seven days now: it and everything it owns are forgotten for good.
- [team fork-policy set](/reference/team.fork-policy.set.md): Set where a Team's private repositories may be forked: anywhere their settings allow, only within the Team, or nowhere.
- [team fork-policy show](/reference/team.fork-policy.show.md): Where a Team's private repositories may be forked.
- [team invitation accept](/reference/team.invitation.accept.md): Accept an invitation to a Team.
- [team invitation list](/reference/team.invitation.list.md): List your open Team invitations.
- [team invite](/reference/team.invite.md): Invite someone to a Team by email.
- [team member remove](/reference/team.member.remove.md): Remove a Member from a Team.
- [team member role set](/reference/team.member.role.set.md): Change a Member's role.
- [team restore](/reference/team.restore.md): Bring back a Team deleted in the last seven days, with everything it owns.
- [team role delete](/reference/team.role.delete.md): Delete a role the Team made.
- [team role list](/reference/team.role.list.md): List a Team's roles and every permission a role can hold.
- [team role set](/reference/team.role.set.md): Create a role, or change one the Team made.
- [team show](/reference/team.show.md): Show a Team and its Members.
- [team sso delete](/reference/team.sso.delete.md): End the Team's SSO: its connection is disconnected and its domains sign in as anyone's.
- [team sso set](/reference/team.sso.set.md): Sign the Team's people in through your company's identity provider, for the domains you name; returns the link your IT admin connects it with.
- [team sso show](/reference/team.sso.show.md): Show the Team's SSO: its domains, whether each is verified, its state and fresh setup links.
- [team token revoke-all](/reference/team.token.revoke-all.md): End every sign-in and personal token of the Team's Members, yours and agents' too, for the Team's resources; Members sign in again and make new tokens (owners).
- [team webhook create](/reference/team.webhook.create.md): Send the Team's events, or one of its agents' (with --agent), to an https endpoint; shows its signing secret once.
- [team webhook delete](/reference/team.webhook.delete.md): Remove an endpoint and what was sent to it.
- [team webhook delivery create](/reference/team.webhook.delivery.create.md): Send an endpoint a test delivery (webhook.ping) now, and show how it went.
- [team webhook delivery list](/reference/team.webhook.delivery.list.md): List what was sent to an endpoint, the newest first: each delivery's status and last answer.
- [team webhook delivery start](/reference/team.webhook.delivery.start.md): Send a delivery again, from the first of its tries.
- [team webhook edit](/reference/team.webhook.edit.md): Change an endpoint's address, events or description, or disable or enable it.
- [team webhook list](/reference/team.webhook.list.md): List the Team's webhook endpoints.
- [team webhook rotate](/reference/team.webhook.rotate.md): Give an endpoint a new signing secret, shown once; the one before signs too for a day.
- [team webhook show](/reference/team.webhook.show.md): Show a webhook endpoint.
- [Identity reference](/reference/products/identity.md): Every Identity command, with its HTTP request and MCP call.
- [me edit](/reference/me.edit.md): Change your name, bio, colour or photo.
- [me show](/reference/me.show.md): Show who you are signed in as, and your Teams.
- [me two-factor approve](/reference/me.two-factor.approve.md): Turn on two-factor with a code from your authenticator app; shows your recovery codes once, each good for one sign-in without the app.
- [me two-factor delete](/reference/me.two-factor.delete.md): Turn off two-factor, with a code from your authenticator app or a recovery code.
- [me two-factor show](/reference/me.two-factor.show.md): Show whether signing in asks for a code from your authenticator app, and how many recovery codes you have left.
- [me two-factor start](/reference/me.two-factor.start.md): Start turning on two-factor: add the secret it shows once to your authenticator app, then approve with a code from it within ten minutes.
- [signin activity list](/reference/signin.activity.list.md): What was changed from one sign-in, the latest first.
- [signin list](/reference/signin.list.md): List where you are signed in, the latest first.
- [signin revoke](/reference/signin.revoke.md): Sign out one place: its tokens stop working at once, and the others go on.
- [token create](/reference/token.create.md): Create a personal token for scripts and CI.
- [token list](/reference/token.list.md): List your personal tokens.
- [token revoke](/reference/token.revoke.md): Revoke a personal token.
- [Usage reference](/reference/products/usage.md): Every Usage command, with its HTTP request and MCP call.
- [usage budget set](/reference/usage.budget.set.md): Set what a cycle may spend and what happens at it: throttle, pause writes, or keep to a ceiling.
- [usage ceiling set](/reference/usage.ceiling.set.md): Set what one resource may spend in a cycle, or null for its default.
- [usage credits add](/reference/usage.credits.add.md): Buy prepaid credits, a credit a dollar: charged to the saved payment method, or returns a checkout page.
- [usage invoice list](/reference/usage.invoice.list.md): List the Team's Invoices, newest first.
- [usage invoice show](/reference/usage.invoice.show.md): Show one Invoice: what was bought, and what it cost.
- [usage lift](/reference/usage.lift.md): Lift a resource's slow-down for unusual usage.
- [usage payment-method open](/reference/usage.payment-method.open.md): Open the page where the Team's payment method is added or changed.
- [usage plan set](/reference/usage.plan.set.md): Choose the paid plan, paying for the rest of this month, or Free from next month.
- [usage recharge set](/reference/usage.recharge.set.md): Buy credits whenever prepaid credits fall below a line, or stop with --below null.
- [usage show](/reference/usage.show.md): Show a Team's credits, budget, this cycle's spend by resource, and why anything slowed.
- [Notifications reference](/reference/products/notifications.md): Every Notifications command, with its HTTP request and MCP call.
- [notification list](/reference/notification.list.md): List your notifications, the newest first: how your runs and deployments ended; --waiting lists what waits on you instead.
- [notification read](/reference/notification.read.md): Mark notifications read: those named, or every one; with --repository and --snapshot, a default-branch head as handled, for agents set to work on its changes.
- [notification settings set](/reference/notification.settings.set.md): Choose when you are emailed; every notification is in your inbox either way.
- [notification settings show](/reference/notification.settings.show.md): Show when you are emailed: important (failures and what waits on you), everything, or nothing.
- [Git reference](/reference/products/git.md): Every Git command, with its HTTP request and MCP call.
- [git merge-request open](/reference/git.merge-request.open.md): Open a merge request from a branch pushed with Git.
- [git show](/reference/git.show.md): The repository's Git mirror: its address, and the Git commit each version became.
- [GitHub reference](/reference/products/github.md): Every GitHub command, with its HTTP request and MCP call.
- [github installation create](/reference/github.installation.create.md): Start installing Midsummer's GitHub App on a GitHub account for the Team: open the address it returns, and GitHub sends you back once it is installed.
- [github installation delete](/reference/github.installation.delete.md): Remove a GitHub installation from the Team: every repository linked through it is unlinked; uninstall it on GitHub to end its access there.
- [github installation list](/reference/github.installation.list.md): List the Team's GitHub installations.
- [github installation repository list](/reference/github.installation.repository.list.md): List the GitHub repositories one of the Team's installations reaches.
- [github link](/reference/github.link.md): Link a GitHub repository, both ways, through the Team's GitHub installation on its account.
- [github show](/reference/github.show.md): The GitHub repository this one is linked to, its last sync and the pull requests it took.
- [github sync](/reference/github.sync.md): Sync with GitHub now, both ways.
- [github unlink](/reference/github.unlink.md): Unlink GitHub; its Views and merge requests stay.
- [Security reference](/reference/products/security.md): Every Security command, with its HTTP request and MCP call.
- [security resolve](/reference/security.resolve.md): Mark a finding resolved, or reopen it.
- [security scan](/reference/security.scan.md): Scan the default branch; a scan with more to read goes on by itself.
- [security settings set](/reference/security.settings.set.md): Turn security checks on or off.
- [security show](/reference/security.show.md): A repository's security checks, last scan and findings.
- [Builder reference](/reference/products/builder.md): Every Builder command, with its HTTP request and MCP call.
- [builder project create](/reference/builder.project.create.md): Make a Project from a prompt: its repository, a View the agent builds in, and a Preview of what it built; the same --key returns the same Project.
- [builder turn create](/reference/builder.turn.create.md): Change a Project with a prompt: the agent works on its View and the result ships as a Preview; the same --key returns the same Turn.
- [builder turn list](/reference/builder.turn.list.md): List a Project's Turns, its versions, newest first, each with its Checkpoint and Preview.
- [builder turn restore](/reference/builder.turn.restore.md): Bring a Project back to what a Turn ended with, as a new Turn shipped as its own Preview; the same --key returns the same Turn.
- [builder turn show](/reference/builder.turn.show.md): Show a Turn and its agent's events after --after.
- [AI Gateway reference](/reference/products/ai-gateway.md): Every AI Gateway command, with its HTTP request and MCP call.
- [ai ask](/reference/ai.ask.md): Ask a Model with an AI key, as a Project's code does through the SDK; replied to as ai call create replies.
- [ai call create](/reference/ai.call.create.md): Ask a Model for the Team: one prompt or a conversation, replied in whole or streamed, with the tokens and credits it spent.
- [ai key create](/reference/ai.key.create.md): Make an AI key that reaches every Model for the Team's code; shows its secret once.
- [ai key list](/reference/ai.key.list.md): List the Team's AI keys, newest first, without their secrets.
- [ai key revoke](/reference/ai.key.revoke.md): Revoke an AI key, by name or id; its next call is refused.
- [ai model list](/reference/ai.model.list.md): List the Models a call can name, the default first, with their prices in credits per million tokens.
- [ai usage show](/reference/ai.usage.show.md): Show the Team's Model calls since a time (this month unless given): calls, tokens and credits by Model.
- [@midsummer-ai/sdk](/reference/sdk/sdk.md): The SDK: the one package your project's code imports to use Midsummer's products. This entry is storage: your team's files, kept in buckets.
- [@midsummer-ai/sdk/stand-in](/reference/sdk/stand-in.md): Storage's Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It holds no engine code and passes the contract (`@midsummer-ai/sdk/contract`) except durability and scale.
- [@midsummer-ai/sdk/contract](/reference/sdk/contract.md): Storage's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the real Capability runs the same cases against its own engine, through the wire. A behaviour that is not a case here is not promised.
- [@midsummer-ai/sdk/s3](/reference/sdk/s3.md): Storage over the S3 protocol, so the tools and SDKs that speak it reach a Project's Buckets unchanged. `s3(engine, options)` serves one HTTP request from any engine: the Stand-in under `midsummer dev`, or the real Capability's engine on its server. S3 here is the protocol, not a provider.
- [@midsummer-ai/sdk/socket](/reference/sdk/socket.md): Storage's wire over a WebSocket: one connection carries every call, so a client pays for one HTTP request when it connects, not one a call. The frames are the wire's own (`@midsummer/sdk/wire`), each sent with a request id, replied to in any order; `remote` batches over it as over HTTP.
- [@midsummer-ai/sdk/ai](/reference/sdk/ai.md): AI: Model calls from a Project's code, through one AI key, streamed or whole, each with the tokens and credits it spent.
- [@midsummer-ai/sdk/ai/stand-in](/reference/sdk/ai-stand-in.md): AI's Stand-in: Model calls replied to on this computer, for `midsummer dev` and tests, with no Model behind them. It passes the contract (`@midsummer/sdk/ai/contract`); its replies are only an echo of the question, so code can be run end to end without spending credits.
- [@midsummer-ai/sdk/ai/contract](/reference/sdk/ai-contract.md): AI's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the platform runs the same cases through the wire, against a provider of its own. A behaviour that is not a case here is not promised.
- [@midsummer-ai/sdk/client](/reference/sdk/client.md): Storage from code holding a Storage Key, as an app reaches it: calls are written as usual and travel over one WebSocket, so a client pays for one request when it connects, not one a call. Where a connection cannot open, they travel as batched HTTP, signed with the same key.
- [@midsummer-ai/sdk/server](/reference/sdk/server.md): `@midsummer-ai/sdk/server`: what a Project's `db/` functions are written with. Each file of `db/` is a module of functions, each export a function named `<file>.<export>`, referred to by the client as `api.<file>.<export>`:
- [@midsummer-ai/sdk/database/stand-in](/reference/sdk/database-stand-in.md): The Database's Stand-in, for `midsummer dev`: a Project's own `db/` functions run in memory, with the Database's meaning. Mutations run one at a time, each writing all of what it wrote or none of it; a mutation sent again under the same tag applies once; arguments, results and writes are checked against their shapes; a watched query is given its value again after every change; the scheduler runs what it is given. It passes the Database's contract (`@midsummer-ai/sdk/database/contract`) except durability and scale, and holds no engine code.
- [@midsummer-ai/sdk/database/contract](/reference/sdk/database-contract.md): What every Database promises its client, as cases any test runner can run. The Database runs them through its own client and wire, and the Stand-in passes the same cases; a behaviour that is not a case here is not promised.
- [@midsummer-ai/sdk/database/errors](/reference/sdk/database-errors.md): Why a Database refused a call, as the client throws it: the same codes from the Stand-in and the Database.
- [@midsummer-ai/sdk/database](/reference/sdk/database.md): `@midsummer-ai/sdk/database`: a Project's Database, from its app or its server.
- [@midsummer-ai/sdk/database/dev-server](/reference/sdk/database-dev-server.md): The Stand-in over the Database's own wire, for `midsummer dev`: the client connects to it as it connects to a Database, so an app runs against it unchanged. One unit, on one WebSocket a client:
- [@midsummer-ai/sdk/agents](/reference/sdk/agents.md): Agents: what an Agent's one file is, and the runtime that runs it. An Agent's file exports its Agent as default:
- [@midsummer-ai/sdk/agents/stand-in](/reference/sdk/agents-stand-in.md): Agents' Stand-in: runs in memory, for running an Agent's file on this computer and in tests. It keeps a run's calls as the platform does, so a run executed again resumes, and it refuses tools the run is not allowed. Its memory is kept between the runs one Stand-in starts.
- [@midsummer-ai/sdk/agents/contract](/reference/sdk/agents-contract.md): Agents' contract: what every place that keeps Agent runs promises, as cases any test runner can run. The Stand-in runs them in this package; the platform runs the same cases through its wire.
- [@midsummer-ai/sdk/queues](/reference/sdk/queues.md): Queues: a Team's Queues of Messages, which the SDK reaches by the name an Environment binds each one under (`midsummer env binding set`).
- [@midsummer-ai/sdk/queues/stand-in](/reference/sdk/queues-stand-in.md): Queues' Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It holds no engine code and passes the contract (`@midsummer-ai/sdk/queues/contract`) except durability and scale.
- [@midsummer-ai/sdk/queues/contract](/reference/sdk/queues-contract.md): Queues' contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the platform runs the same cases against its own engine, through the wire. A behaviour that is not a case here is not promised.
- [@midsummer-ai/sdk/email](/reference/sdk/email.md): Email from a Project's code: Messages sent from its verified Sending domains.
- [@midsummer-ai/sdk/email/stand-in](/reference/sdk/email-stand-in.md): Email's Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It sends nothing anywhere; what it would send is kept in `sent`. It passes the contract (`@midsummer-ai/sdk/email/contract`) except durability and delivery.
- [@midsummer-ai/sdk/email/contract](/reference/sdk/email-contract.md): Email's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the real Capability runs the same cases against a Project set up with the fixture: `mail.acme.dev` a verified Sending domain, and `suppressed@example.com` suppressed.
- [@midsummer-ai/sdk/email/client](/reference/sdk/email-client.md): Email's wire: code holding an Email key sends through `client`, and the platform replies with `serveMessages`. One Message is one POST of JSON to `<origin>/email/messages` with `authorization: Bearer <the key's secret>`; the answer is the `SentMessage`, or `{ "error": { "code", "message" } }` with the code's status.
- [@midsummer-ai/sdk/email/smtp](/reference/sdk/email-smtp.md): Email for clients that speak only SMTP: a relay that takes mail by SMTP, signed in with an Email key as the password (username `midsummer`), and sends each message through Email's wire, as the SDK's client does. It keeps nothing, so any number of them can run anywhere that can reach the API.
- [@midsummer-ai/sdk/vector](/reference/sdk/vector.md): Vector DB: a Team's Vectors in Vector namespaces, searched by closeness and filtered by their metadata.
- [@midsummer-ai/sdk/vector/stand-in](/reference/sdk/vector-stand-in.md): Vector DB's Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It holds no engine code and passes the contract (`@midsummer/sdk/vector/contract`) except durability and scale. A query is an exact search: every Vector of the namespace is scored, so it returns what an approximate engine aims for.
- [@midsummer-ai/sdk/vector/contract](/reference/sdk/vector-contract.md): Vector DB's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the real Capability runs the same cases against its own engine, through the wire. A behaviour that is not a case here is not promised.

## Sol

- [Commands](/sol/commands.md): Every Sol command in version `0.6.0-alpha.1+e5ddddc5711d32be`, from Sol's built-in help.
- [Sol](/sol.md): Version control that saves as you work. Each task gets its own view, every save can be recovered, and nothing waits for you to commit.
- [sol auth](/sol/commands/auth.md): Sign in, sign out, or inspect authentication.
- [sol commit](/sol/commands/commit.md): Create a named checkpoint for the current state.
- [sol fsck](/sol/commands/fsck.md): Verify stored objects and references.
- [sol hide](/sol/commands/hide.md): Require an audience before a path can be synchronized.
- [sol init](/sol/commands/init.md): Initialize a repository.
- [Install and sign in](/sol/install.md): Install Sol, and sign in to a host.
- [sol auth login](/sol/commands/auth-login.md): Keep a token for one Sol host, such as a self-hosted `sol serve`.
- [sol doctor](/sol/commands/doctor.md): Diagnose repository and capture service health.
- [sol log](/sol/commands/log.md): Show repository history.
- [sol seal](/sol/commands/seal.md): Encrypt a protected path for synchronization.
- [sol status](/sol/commands/status.md): Show the active branch, current changes, and how it stands against each remote.
- [Quickstart](/sol/quickstart.md): Create a repository, save a checkpoint, work in a view and open a merge request.
- [sol auth logout](/sol/commands/auth-logout.md): Forget the token kept for a host, or every kept token.
- [sol context](/sol/commands/context.md): Show net changes, overlapping View work and recorded checks.
- [sol op](/sol/commands/op.md): Inspect or annotate an operation.
- [sol open](/sol/commands/open.md): Stop encrypting a path on future synchronization.
- [sol storage](/sol/commands/storage.md): Inspect or prune repository storage.
- [sol auth status](/sol/commands/auth-status.md): Show who you're signed in as and where Sol gets tokens, without printing them.
- [sol op show](/sol/commands/op-show.md): Show one operation and its file changes.
- [sol sealed](/sol/commands/sealed.md): List encrypted paths.
- [sol storage inspect](/sol/commands/storage-inspect.md): Show repository storage and shared cache usage separately.
- [sol view](/sol/commands/view.md): Create or retire an isolated View.
- [sol audience](/sol/commands/audience.md): Create or rotate encryption audiences.
- [sol auth helper](/sol/commands/auth-helper.md): Show, set or remove the credential helper Sol asks for tokens and repository names.
- [sol op note](/sol/commands/op-note.md): Edit an operation's explanation without changing its identity.
- [sol storage prune](/sol/commands/storage-prune.md): Show or remove unreachable stored data.
- [sol view list](/sol/commands/view-list.md): List Views.
- [sol access](/sol/commands/access.md): Set repository, branch, or merge-request access.
- [sol audience create](/sol/commands/audience-create.md): Create a new audience key.
- [sol bench](/sol/commands/bench.md): Run the built-in 100,000-file benchmark.
- [sol smartlog](/sol/commands/smartlog.md): Show branches, Views, checkpoints, remotes, and merge requests.
- [sol view create](/sol/commands/view-create.md): Create a named View.
- [sol audience rotate](/sol/commands/audience-rotate.md): Replace an audience key for future sealed content.
- [sol mr](/sol/commands/mr.md): Manage merge requests.
- [sol perf](/sol/commands/perf.md): Show latency history or control live command timings.
- [sol show](/sol/commands/show.md): Show details or file contents for a reference.
- [sol view move](/sol/commands/view-move.md): Move a View onto another state of its base, keeping only the View's own changes.
- [sol keys](/sol/commands/keys.md): Export or import an audience key.
- [sol mr verify](/sol/commands/mr-verify.md): Run declared checks on the exact merge candidate and record their evidence.
- [sol perf on](/sol/commands/perf-on.md): Show elapsed time after human-readable commands.
- [sol restore](/sol/commands/restore.md): Restore a file from a checkpoint, save or the View base.
- [sol view split](/sol/commands/view-split.md): Move a View's changes to some paths into a new View on the same base.
- [sol keys export](/sol/commands/keys-export.md): Export an audience key to an explicit private file.
- [sol mr list](/sol/commands/mr-list.md): List merge requests.
- [sol perf off](/sol/commands/perf-off.md): Hide elapsed time after commands.
- [sol undo](/sol/commands/undo.md): Undo a change without discarding history.
- [sol view squash](/sol/commands/view-squash.md): Combine a View's own unpublished operations into one.
- [sol keys import](/sol/commands/keys-import.md): Import an audience key from an explicit private file.
- [sol mcp](/sol/commands/mcp.md): Serve Sol tools to agents over MCP.
- [sol mr show](/sol/commands/mr-show.md): Show a merge request, merge status, and optional changes.
- [sol redo](/sol/commands/redo.md): Reapply the last undone operation.
- [sol view remove](/sol/commands/view-remove.md): Retire a View whose work is already preserved.
- [How capture works](/sol/capture.md): Why Sol has no staging, what it records when you save, and what a checkpoint adds.
- [sol env](/sol/commands/env.md): Manage repository environment values.
- [sol mr open](/sol/commands/mr-open.md): Push the source branch and open a merge request.
- [sol recover](/sol/commands/recover.md): Find and restore recoverable work.
- [sol serve](/sol/commands/serve.md): Answer push, pull and clone for the repositories in a directory over stdin and stdout: what an ssh:// remote runs on the far side.
- [sol views](/sol/commands/views.md): List Views.
- [sol completion](/sol/commands/completion.md): Generate shell completions from the installed command model.
- [sol env set](/sol/commands/env-set.md): Set a repository environment value.
- [sol mr stack](/sol/commands/mr-stack.md): Show a merge-request stack in merge order.
- [sol read](/sol/commands/read.md): Print a file without checking it out.
- [sol recover list](/sol/commands/recover-list.md): List recoverable operations and individual saves, including deleted drafts.
- [Views](/sol/views.md): A separate folder for each task, which is also its own branch.
- [Remotes](/sol/remotes.md): The three kinds of remote, and what push and pull do.
- [sol env remove](/sol/commands/env-remove.md): Remove a repository environment value.
- [sol ls](/sol/commands/ls.md): List a directory.
- [sol mr check](/sol/commands/mr-check.md): Record a check result.
- [sol recover show](/sol/commands/recover-show.md): Show one recoverable operation or save.
- [History and recovery](/sol/history-and-recovery.md): Operations, checkpoints and saves, and why nothing you do throws work away.
- [sol diff](/sol/commands/diff.md): Show the lines that changed: since the last checkpoint on a branch, against its branch in a View, or between two states; or inspect operation changes.
- [sol env list](/sol/commands/env-list.md): List environment values and sealed secret names.
- [sol mr review](/sol/commands/mr-review.md): Approve a merge request or request changes.
- [sol recover restore](/sol/commands/recover-restore.md): Restore a reference into a new View.
- [Privacy and sealing](/sol/privacy.md): Audiences, sealed paths, secrets and embargoes, so a host stores only encrypted files.
- [sol env run](/sol/commands/env-run.md): Run a command with the repository environment.
- [sol merge](/sol/commands/merge.md): Merge the current View into its parent; keep it if automatic retirement is blocked.
- [sol mr comment](/sol/commands/mr-comment.md): Add a comment.
- [sol resolve](/sol/commands/resolve.md): Resolve a file conflict: accept the edited file, or keep one side.
- [sol branch](/sol/commands/branch.md): List or manage branches.
- [sol mr resolve-comment](/sol/commands/mr-resolve-comment.md): Resolve a discussion thread.
- [sol pick](/sol/commands/pick.md): Copy operations into this View or branch, or into another View, as one new operation.
- [sol secret](/sol/commands/secret.md): Manage sealed repository secrets.
- [sol branch list](/sol/commands/branch-list.md): List branches and mark the active branch.
- [sol handoff](/sol/commands/handoff.md): Report context for another person or agent.
- [sol mr merge](/sol/commands/mr-merge.md): Merge an eligible merge request.
- [sol secret set](/sol/commands/secret-set.md): Seal a value read from a file for one audience, or give it to the host that keeps the values.
- [sol branch create](/sol/commands/branch-create.md): Create a branch at the current state or a named checkpoint.
- [sol history](/sol/commands/history.md): Show changes to one path.
- [sol mr update](/sol/commands/mr-update.md): Update the source View from the target branch and reset its review.
- [sol secret remove](/sol/commands/secret-remove.md): Remove a sealed repository environment value.
- [sol blame](/sol/commands/blame.md): Attribute current lines to their latest changing operation.
- [sol branch rename](/sol/commands/branch-rename.md): Rename a branch without changing its state.
- [sol mr close](/sol/commands/mr-close.md): Close a merge request without merging it.
- [sol secret list](/sol/commands/secret-list.md): List sealed value names without revealing their contents.
- [sol branch delete](/sol/commands/branch-delete.md): Delete a branch that is not active, or with --remote, a branch on a remote.
- [sol embargo](/sol/commands/embargo.md): Create, list, or reveal publication embargoes.
- [sol reflog](/sol/commands/reflog.md): Show recoverable operations.
- [sol release](/sol/commands/release.md): Create an immutable release.
- [sol artifact](/sol/commands/artifact.md): Record an immutable artifact built from an exact source version.
- [sol embargo create](/sol/commands/embargo-create.md): Seal a path until an explicit reveal.
- [sol obliterate](/sol/commands/obliterate.md): Remove every version of files or folders from all history, keeping history's shape.
- [sol switch](/sol/commands/switch.md): Switch branches.
- [Work in a view](/sol/work-in-a-view.md): Start a task in its own view, see what changed, and keep several tasks apart.
- [Merge and resolve conflicts](/sol/merge-and-resolve.md): Merge a view, resolve the lines both sides changed, and merge only part of a view.
- [sol deployment](/sol/commands/deployment.md): Record where an artifact is deployed.
- [sol embargo reveal](/sol/commands/embargo-reveal.md): Reveal an embargoed path.
- [sol remote](/sol/commands/remote.md): List or manage remotes.
- [sol embargo list](/sol/commands/embargo-list.md): List publication embargoes.
- [sol provenance](/sol/commands/provenance.md): Verify the source behind a release.
- [sol remote list](/sol/commands/remote-list.md): List configured remotes.
- [Undo and recover](/sol/undo-and-recover.md): Take back a change, restore a file, and find work you thought was gone.
- [Merge requests](/sol/merge-requests.md): Open, stack, review and merge merge requests on Orbit from your checkout.
- [sol remote add](/sol/commands/remote-add.md): Add a new remote without replacing an existing name.
- [sol remote set-url](/sol/commands/remote-set-url.md): Change a remote URL and reset its tracking state.
- [Use Git](/sol/use-git.md): Import a Git repository with its history, export back to Git, and find the Git commit for a Sol state.
- [Seal files and secrets](/sol/seal-files.md): Create an audience, seal paths and secrets to it, and share its key.
- [sol remote rename](/sol/commands/remote-rename.md): Rename a remote and its tracking state.
- [Run checks](/sol/run-checks.md): Declare the checks a change must pass, run them against your current files, and read their results.
- [sol remote remove](/sol/commands/remote-remove.md): Remove a remote and its tracking state.
- [Host your own remote](/sol/host-a-remote.md): Share repositories from a folder, on this machine or another over SSH.
- [sol push](/sol/commands/push.md): Push the active branch to a remote.
- [sol pull](/sol/commands/pull.md): Pull the active branch from a remote.
- [Use with agents](/sol/use-with-agents.md): Give agents Sol over MCP, hand work between agents, and run many agents in one repository.
- [Remove a file from history](/sol/remove-from-history.md): Remove every version of a file from all history, here and on each remote.
- [sol clone](/sol/commands/clone.md): Clone a repository.
- [sol git](/sol/commands/git.md): Import, export, and update Git repositories.
- [sol git pull](/sol/commands/git-pull.md): Update the active Sol branch from its mapped Git branch.
- [sol git resolve](/sol/commands/git-resolve.md): Find the Git commit for an exported Sol reference.
- [sol git import](/sol/commands/git-import.md): Import a Git repository and its history.
- [sol git export](/sol/commands/git-export.md): Export the repository and its history to Git.
- [sol verify](/sol/commands/verify.md): Run declared checks, or an ad-hoc command, against the current source state.