Skip to content

docs: agents overview drops gated actions and observe hook #89

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tonychang04 merged 1 commit into from
Sep 3, 2026
Merged

docs: agents overview drops gated actions and observe hook #89

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 3 additions & 5 deletions docs/agents/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,13 @@
---
title: "Agents overview"
description: "The `insta` skill, the MCP server, and the governance model for agents."
description: "How agents connect: the `insta` skill and the MCP server."
---

InstaCloud is agent-native: the stack is designed so that everything you can do in the console, an agent can do through the `insta` CLI or an MCP tool call. These are the pieces that make it true:

- **[Agent setup](/agents/setup).** One command, `insta setup agent`, installs the skill and registers the MCP server for the agents on your machine.
- **[The `insta` skill](/agents/skills).** Teaches terminal agents (Claude Code, Cursor, Codex, and others) the workflow: check `insta status`, work on a branch, pull secrets through the seam, deploy, relay approval requests.
- **[The `insta` skill](/agents/skills).** Teaches terminal agents (Claude Code, Cursor, Codex, and others) the workflow: check `insta status`, work on a branch, pull secrets through the seam, deploy.
- **[MCP server](/agents/mcp-server).** `https://mcp.instacloud.com/mcp` exposes the `insta_*` toolset ([reference](/reference/mcp-tools)) over streamable HTTP, authenticated with OAuth or an `insta_` API token. Explicit `projectId` and `branch` arguments let an agent operate on any project its token can see, no linked directory required.
- **[One branch per task](/agents/branch-per-task).** An agent task gets its own branch: its own database with real data, its own storage, its own compute URL. Mistakes stay on the branch and get deleted with it.
- **[Gated actions](/reference/gated-actions).** A gated action returns an approval ID instead of executing; a human admin approves or denies, and grants are single-use and audited. Set the policy before the agent starts: `insta policy set project.delete approve`.
- **[Observe hook](/reference/cli/overview#observe).** Linking a repo (`insta project create` or `insta project link`) adds a credential audit on agent tool calls that writes findings to `.insta/audit.jsonl`.

Mix CLI and MCP freely; both hit the same API under the same governance.
Run `insta setup agent` once, and any operation on your projects, from provisioning a database to deploying compute, is one your agents can run. Mix CLI and MCP freely; both hit the same API.
Loading