# Agent settings

> Change an agent you own: name, ACP agent, session defaults, access, packs, secrets, knowledge, runtime, automations, startup tasks, hooks, and activity.

Section: Your agents · Updated: 2026-11-19 · Canonical: https://nested.me/docs/agent-settings

Agent settings is where the owner of an agent edits it and manages its deployment. Other people can chat with a shared agent but see “You can chat with this agent, but only its owner can change settings.”

## Before you start

- You must own the agent.
- Open settings from any of these places: **Settings for {name}** on the agent’s row in the sidebar **Agents** group, **Agent settings** in the composer’s agent picker, **Agent settings** in the task panel’s **Agent** section, the agent’s row in **Settings → Agents**, or Cmd/Ctrl+Enter on the agent in the command palette.

## Sections

The settings rail lists these sections. **Startup tasks**, **Lifecycle hooks**, and **Activity** sit under **Advanced**.

| Section | What you change |
| --- | --- |
| **Agent** | Name, **ACP agent** (takes effect on redeploy), **Session defaults** for every new task, **Access** (“Who can send tasks”: Only me or Anyone signed in), **Resource usage**, and **Delete agent**. |
| **Packs** | Attach or remove packs from the catalog. **Explore** previews a pack. Each attached pack shows whether its required secrets are attached. |
| **Secrets** | Variables the packs declare, marked **Required** or **Optional**, with **Attach secret** or **Change secret**. Add extra variables that no pack declares. |
| **Knowledge** | Shared knowledge centers the agent can read or write. See [Shared knowledge centers](https://nested.me/docs/knowledge). |
| **Runtime** | Status plus **Start**, **Stop**, **Deploy**, and **Undeploy**. An **Isolated VM** badge marks an agent that runs in its own virtual machine. Also the **Accounts** card for vendor sign-ins. See [Agent sign-in and accounts](https://nested.me/docs/agent-accounts). |
| **Automations** | This agent’s automations, **New automation**, and links to the raw bindings: Schedules, Webhooks, Slack, and GitHub. |
| **Startup tasks** | Messages that run each time the agent process starts. See [Startup tasks and lifecycle hooks](https://nested.me/docs/startup-hooks). |
| **Lifecycle hooks** | Shell or HTTP callbacks before and after sessions and prompts. |
| **Activity** | **Timeline** of lifecycle events, **Metrics** (turns, tokens), and the agent’s day, week, and month **Reports**. |

## Steps

1. Open the agent’s settings and select a section.
2. Make your change. A save bar shows **Unsaved changes**, or **Unsaved · this change restarts the agent** when the change needs a restart.
3. Select **Save & redeploy** to apply the change now, **Save only** to apply it on the next deploy, or **Discard**.
4. Watch the status line. If a task is still running, Nested does not restart the agent and tells you the change was not applied; try again when the work finishes.

> [!WARNING]
> **Delete agent** undeploys the agent and removes it from your list. Its workspaces and tasks are no longer available.

## Example

Rename `research` to `briefing`, switch **Access** to **Only me**, and select **Save only**. Later, on **Runtime**, select **Stop** to free the cluster overnight and **Start** in the morning.

## Questions

### Why can’t I open settings for an agent I use every day?

Only the agent’s owner can change its settings. A shared agent you did not create is chat-only for you.

### What is the difference between Stop and Undeploy?

**Stop** scales the running agent down and keeps its deployment, so **Start** brings it back. **Undeploy** removes the deployment; you can **Deploy** it again later.

[Open in Nested](https://app.nested.me/settings/agents)

## Related

- [Deploy an agent](https://nested.me/docs/deploy)
- [Shared knowledge centers](https://nested.me/docs/knowledge)
- [Agent sign-in, accounts, and auto-stop](https://nested.me/docs/agent-accounts)
- [Startup tasks and lifecycle hooks](https://nested.me/docs/startup-hooks)
