# Nested docs

Nested runs specialized coding agents on Kubernetes you control. These docs cover the concepts, every screen of the app, automations, and the platform underneath.

## Start here

What Nested is, your first agent and task, and the guided tours.

- [What is Nested](https://nested.me/docs/introduction): Nested runs specialized coding agents on Kubernetes you control. Learn what it is, who it is for, and how the app, console, and runtime fit together.
- [Quickstart](https://nested.me/docs/getting-started): Sign in, deploy your first agent, start a task, answer it from Needs you, and hand recurring work to an automation — in about ten minutes.
- [Product tours](https://nested.me/docs/tours): Four short desktop walkthroughs — deploy an agent, connectors, scheduled tasks, workspaces and tasks — that you can start, skip, or replay anytime.

## Concepts

The words Nested uses — agents, packs, workspaces, tasks, formulas, memories — and how they fit together.

- [Glossary](https://nested.me/docs/concepts): The words Nested uses — agent, pack, skill, formula, workspace, task, automation, connector, memory, team — and how they fit together.
- [How tasks work](https://nested.me/docs/tasks-lifecycle): A task’s life in Nested: running, needs you, completed, canceled, failed, or rejected — plus reopening, queued messages, subtasks, and automated tasks.
- [Teams](https://nested.me/docs/teams): Every agent, workspace, and task belongs to a team. Create or join a team, invite members, set roles, and handle agents left behind by former members.

## Chat and tasks

Workspaces, parallel task threads, formula runs, and the composer tools that make writing faster.

- [Chat, workspaces, and tasks](https://nested.me/docs/chat): Use the task list, pick an agent and workspace in the composer, create folder or repository workspaces, and run several tasks in parallel.
- [Needs you: tasks waiting on you](https://nested.me/docs/attention): When a task needs your answer, sign-in, or decision, Nested moves it to Needs you at the top of the task list — without pulling you out of your thread.
- [Writing faster in chat](https://nested.me/docs/assist): Rephrase a draft, dictate by voice, summarize a long reply, read it aloud, and turn any agent message into subtasks — without leaving the thread.
- [Formula runs in chat](https://nested.me/docs/formulas): A formula run opens on its own canvas: see where it is, act on checks, decisions, and inputs, open a step’s chat, and cancel or restart the run.
- [The task panel, changes, and worktrees](https://nested.me/docs/task-panel): See a task’s agent, session, memory, environments, and changed files beside the chat; review diffs; and run repository tasks in separate worktrees.
- [Share, export, and runbooks](https://nested.me/docs/share-export): Share a task with a public read-only link, export its history as Markdown, and read the runbook — the agent’s turn-by-turn log.
- [Command palette](https://nested.me/docs/command-palette): Press Cmd/Ctrl+K to start a task with any agent, open an agent’s settings, jump to any page, or switch teams from the keyboard.
- [The composer](https://nested.me/docs/composer): Attach files, reuse drafts, reference other tasks, set session options, run slash commands, choose memory, and queue messages while the agent works.

## Your agents

Deploy an agent, then shape its settings, shared knowledge, memories, and machine.

- [Deploy an agent](https://nested.me/docs/deploy): Deploy a Nested agent: choose a base, packs, and a coding agent (Cursor, Claude Code, Kimi CLI), attach secrets, and choose who can chat with it.
- [Agent settings](https://nested.me/docs/agent-settings): Change an agent you own: name, ACP agent, session defaults, access, packs, secrets, knowledge, runtime, automations, startup tasks, hooks, and activity.
- [Shared knowledge centers](https://nested.me/docs/knowledge): Attach shared knowledge centers to an agent so it can read or update your docs, runbooks, or team wiki during tasks, with read-only or read-and-write access.
- [Memories](https://nested.me/docs/memory): Memories hold what your agents learn about you and your work. Create, search, edit, restore, and reorganize them, and choose which tasks use them.
- [Desktop and Terminal](https://nested.me/docs/desktop-terminal): Open an agent’s graphical desktop or a shell on its machine to watch work, verify results, or finish a sign-in, from the task panel or Settings → Agents.
- [Agent sign-in, accounts, and auto-stop](https://nested.me/docs/agent-accounts): Sign an agent in to its coding vendor, keep several vendor accounts and switch between them, and restart an agent that stopped after a quiet period.
- [Startup tasks and lifecycle hooks](https://nested.me/docs/startup-hooks): Run messages every time an agent starts, and call shell scripts or HTTP endpoints before and after each session or prompt with lifecycle hooks.
- [Site logins](https://nested.me/docs/site-logins): Save website sign-ins your agents can use, including authenticator keys for two-step codes, and choose which agents may sign in without asking you.
- [Environments](https://nested.me/docs/environments): See the short-lived machines your agents create to run code, open their preview links, and keep, extend, or destroy them from a task or the Environments page.
- [Packs](https://nested.me/docs/packs-page): Browse your packs, your team’s packs, and the global catalog. Copy catalog packs, change visibility, review revisions, and attach packs to agents.

## Automations

Run an agent on a schedule or when something happens — GitHub, Slack, webhooks, and more.

- [Automations](https://nested.me/docs/automations): Run a Nested agent on a schedule or when something happens in GitHub, Slack, Sentry, or a webhook. Every run opens a task and lands in the automation’s history.
- [Scheduled tasks](https://nested.me/docs/schedules): Have a Nested agent start a prompt on chosen days and times or at a repeating interval, in a workspace you choose, with pause, run now, and history.
- [Webhooks](https://nested.me/docs/webhooks): Turn inbound HTTP requests into Nested tasks: route, HMAC or token verification, Go-template task bodies with .JSON fields, deliveries, and redelivery.
- [GitHub](https://nested.me/docs/github): Connect the Nested GitHub App, then start agent tasks from pull requests, reviews, comments, pushes, and CI with automations or raw repository bindings.
- [Slack bots](https://nested.me/docs/bots): Connect a Slack workspace to Nested, start agent tasks from mentions, channel messages, or emoji reactions, and post the agent’s answer back to Slack.
- [Sentry](https://nested.me/docs/sentry): Connect a Sentry Internal Integration so new Sentry issues and events start Nested agent tasks, with signed webhooks and issue comments.

## Your account

Overview, reports, preferences, secrets, notifications, connectors, and the pack builder.

- [Overview of running work](https://nested.me/docs/overview): See in-progress tasks, the latest weekly report, recent automation runs, token usage and estimated cost, and your agents on one Overview page.
- [Task timeline](https://nested.me/docs/timeline): Browse a chronological, day-by-day history of tasks across all your agents and workspaces, with each task’s state, in the Nested task timeline.
- [Reports](https://nested.me/docs/reports): Read closed day, week, and month reports for your agents: task, automation, formula, and schedule counts, latency, missing days, and PNG or PDF downloads.
- [Preferences and profile](https://nested.me/docs/preferences): Set theme, text size, read-aloud, motion, and language in Nested, and manage your display name, phone, passkeys, and sign-out in your profile.
- [Sign-in and passkeys](https://nested.me/docs/sign-in-passkeys): Sign in to Nested with a passkey, email and password, or Google; add and manage passkeys; and approve apps that ask to sign you in with Nested.
- [Secrets](https://nested.me/docs/secrets): Store API keys, tokens, and kubeconfigs as write-only secrets in Nested, keep them private or share them with your team, and attach them to agents.
- [Notifications](https://nested.me/docs/notifications): Get notified when a task needs you, a task finishes, an agent’s status changes, or a formula needs a decision — in the browser or in the background.
- [Connectors](https://nested.me/docs/connectors): Connect the tools your Nested agents use on your behalf — OAuth or MCP connectors — reconnect expired ones, and add custom team connectors.
- [Pack builder](https://nested.me/docs/pack-builder): Build a Nested pack on desktop: describe it, start from a template, import skills from Git, edit every section, verify the archive, and upload it to your team.
- [Dictation](https://nested.me/docs/dictation): Dictate messages in Nested with the browser’s speech service or Whisper running on your own device, and tune language, model, and your custom words.
- [Activity log](https://nested.me/docs/activity-log): Review what you did in Nested: a filterable audit log of your account’s actions over about 90 days, with before-and-after detail for each change.
- [Install the Nested app](https://nested.me/docs/install-app): Install Nested on your desktop or phone home screen as an app, enable background notifications on iOS, and reload when an update is available.

## Platform

How Nested runs on your Kubernetes: architecture, the agent runtime, packs, security, and installation.

- [Architecture](https://nested.me/docs/architecture): What Nested installs into your Kubernetes cluster — control plane, agent pods, and platform services — and how a task flows through them.
- [Agent runtime](https://nested.me/docs/agent-runtime): How a Nested agent pod works: coding agents over ACP, task sessions, the sandbox, idle stop and wake, crash recovery, and settings reloads.
- [Packs](https://nested.me/docs/packs): The pack format: skills, subagents, formulas, MCP servers, setup scripts, and guides in one verified, versioned archive you attach to agents.
- [Formula reference](https://nested.me/docs/formula-reference): The schema-2 formula format: typed input, steps, gates, checks, human input, state, limits, and how runs execute, fail, and restart.
- [Tasks and agent collaboration](https://nested.me/docs/agent-collaboration): How Nested tasks work under the hood — states, claiming, runbooks — and how agents find each other and delegate work with A2A.
- [Knowledge and memory internals](https://nested.me/docs/knowledge-model): How knowledge centers and user memories store pages, control access, keep versions, and how agents recall and save what they learn.
- [MCP servers and connectors](https://nested.me/docs/mcp-and-connectors): Where agent tools come from — the built-in Nested MCP server, connectors, and pack MCP servers — and how the catalog and Code Mode save tokens.
- [Environments service](https://nested.me/docs/environments-platform): How Nested Environments create short-lived machines for agents: the manifest, Docker and Kubernetes runtimes, lifetimes, and isolation.
- [Security model](https://nested.me/docs/security): How Nested protects your data: deployment boundary, sign-in and tokens, encryption at rest, secrets, agent isolation, teams, and the audit log.
- [Install Nested](https://nested.me/docs/install): Install a Nested cell on your Kubernetes with nested-install: requirements, the setup file, the install steps, upgrades, backups, and teardown.
