> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joystream.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage agents

> search, install, visibility, copy, move, duplicate, and delete.

## Sharing an agent across the organization

An agent's visibility controls who can find it.

```bash theme={null}
jstm agent visibility month-end-close ORG_VISIBLE
```

| Value         | Who can see it                                                |
| ------------- | ------------------------------------------------------------- |
| `PRIVATE`     | The owning workspace only                                     |
| `ORG_VISIBLE` | Any workspace in the organization can discover and install it |
| `PUBLIC`      | Discoverable beyond the organization                          |

## `jstm agent search`

Search the registry for agents other workspaces have made org-visible.

```bash theme={null}
jstm agent search invoice
jstm agent search --org acme-corp --json
```

| Option   | Description                                       |
| -------- | ------------------------------------------------- |
| `QUERY`  | Search text, matched against name and description |
| `--org`  | Filter to a specific organization                 |
| `--json` | Emit as JSON                                      |

## `jstm agent install`

Install an agent from the registry into your active workspace. Accepts a handle, UUID, or FQN.

```bash theme={null}
jstm agent install acme-corp/finance/month-end-close
```

Installing gives you your own installation of someone else's agent. It runs with your workspace's credentials, and the original stays owned where it was built.

## `jstm agent installations`

List agent installations in your active workspace, including their schedules and next fire times.

```bash theme={null}
jstm agent installations
```

The installation id shown here is what [`jstm agent schedule`](/cli/agent-schedule) takes.

## `jstm agent uninstall`

```bash theme={null}
jstm agent uninstall 8c41f2b9-77de-4a30-b0c5-2e1f6a9d4b77
jstm agent uninstall 8c41f2b9-77de-4a30-b0c5-2e1f6a9d4b77 --yes
```

| Option        | Description           |
| ------------- | --------------------- |
| `--yes`, `-y` | Skip the confirmation |
| `--json`      | Emit as JSON          |

## `jstm agent copy`

Copy an agent to another workspace. The original stays where it is.

```bash theme={null}
jstm agent copy month-end-close --to acme-corp/revops
```

<ParamField path="--to" required>
  Destination workspace, as a handle, UUID, or FQN.
</ParamField>

## `jstm agent move`

Move an agent to another workspace. The original workspace no longer owns it.

```bash theme={null}
jstm agent move month-end-close --to acme-corp/finance
```

Use `move` when an agent was built in the wrong place — for example, drafted in a personal workspace and now ready to belong to the team that owns the work.

## `jstm agent duplicate`

Duplicate an agent inside the same workspace. Useful as a starting point for a variant.

```bash theme={null}
jstm agent duplicate month-end-close
```

## `jstm agent delete`

```bash theme={null}
jstm agent delete month-end-close
jstm agent delete month-end-close --yes
```

<Warning>
  Deleting an agent removes it and its history. Consider changing its visibility to `PRIVATE`, or moving it, before deleting.
</Warning>

| Option        | Description                  |
| ------------- | ---------------------------- |
| `--yes`, `-y` | Skip the confirmation prompt |
| `--json`      | Emit as JSON                 |

## See also

* [Organize and publish agents](/guides/organize-and-publish-agents) — walkthrough.
* [Visibility and discovery](/features/visibility-and-discovery)