# oap CLI reference

> Every oap command family, generated from the CLI itself.

Source: https://openap.org/docs/cli-reference

The `oap` CLI installs, manages, and runs agents. Every command below is generated directly
from the CLI, so it matches the binary you have. Pick a family for its subcommands and flags.

## Families

| Family | What it does |
| --- | --- |
| [`oap agent`](https://openap.org/docs/oap-agent) | Manage and run AgentClass resources |
| [`oap artifact`](https://openap.org/docs/oap-artifact) | Inspect versioned artifacts and their revisions |
| [`oap audit`](https://openap.org/docs/oap-audit) | Verify the tamper-evident audit log of a session |
| [`oap build`](https://openap.org/docs/oap-build) | Build (and load) Docker images |
| [`oap channel`](https://openap.org/docs/oap-channel) | Manage Channel CRs (Slack, browser, GitHub webhooks, schedules, ...). |
| [`oap check`](https://openap.org/docs/oap-check) | verify namespace, CRDs, services, and every registered component's health |
| [`oap class`](https://openap.org/docs/oap-class) | Inspect SpiceboxClass resources (sandbox image + capability descriptors) |
| [`oap clean`](https://openap.org/docs/oap-clean) | Remove everything oap installed (CRs → operator → CRDs → namespace) |
| [`oap desktop`](https://openap.org/docs/oap-desktop) | Run the oap macOS menubar app (local VM + built-in chat; macOS/Apple Silicon only) |
| [`oap directory`](https://openap.org/docs/oap-directory) | Configure directory-sync sources (RelationshipSource): Slack, GitHub, 1Password, ... |
| [`oap goals`](https://openap.org/docs/oap-goals) | Manage private goals for a session's owner and agent class |
| [`oap identity`](https://openap.org/docs/oap-identity) | Manage AgentIdentity resources |
| [`oap idp`](https://openap.org/docs/oap-idp) | Manage the cluster identity provider |
| [`oap image`](https://openap.org/docs/oap-image) | Work with local Docker images and the current cluster |
| [`oap init`](https://openap.org/docs/oap-init) | Bring up agent-primitives end-to-end (build + install + check) |
| [`oap install`](https://openap.org/docs/oap-install) | Install the operator + CRDs into the configured cluster |
| [`oap kg`](https://openap.org/docs/oap-kg) | Query the knowledge graph |
| [`oap login`](https://openap.org/docs/oap-login) | Log in to this cluster's identity provider and cache the assertion |
| [`oap logout`](https://openap.org/docs/oap-logout) | Remove the cached identity assertion |
| [`oap memory`](https://openap.org/docs/oap-memory) | Inspect and manage session memory entries |
| [`oap pin`](https://openap.org/docs/oap-pin) | Inspect and update dependency pin baselines |
| [`oap plangate`](https://openap.org/docs/oap-plangate) | Inspect what the plan gate recorded for a session |
| [`oap platform`](https://openap.org/docs/oap-platform) | Manage platform-level admin access (the admin UI gate) |
| [`oap preferences`](https://openap.org/docs/oap-preferences) | Inspect a session's resolved per-user preferences |
| [`oap sandbox`](https://openap.org/docs/oap-sandbox) | Inspect SpiceboxSession resources (per-bundle running sandbox pods) |
| [`oap session`](https://openap.org/docs/oap-session) | Inspect AgentSession resources |
| [`oap settings`](https://openap.org/docs/oap-settings) | Manage cluster-wide agent settings (security defaults wizard + apply). |
| [`oap skill`](https://openap.org/docs/oap-skill) | List, view, create, and delete agent Skills and SkillSources |
| [`oap spicedb`](https://openap.org/docs/oap-spicedb) | Apply schema and check permissions against the system SpiceDB. |
| [`oap tools`](https://openap.org/docs/oap-tools) | Manage tools used by agents (kind-agnostic) |
| [`oap user-identity`](https://openap.org/docs/oap-user-identity) | Manage UserIdentity resources (per-user credential catalogs) |

## Global flags

These persistent flags apply to every command:

```text
--context string        Kubeconfig context to use (default: current-context)
--kubeconfig string     Path to kubeconfig file (default: $KUBECONFIG or ~/.kube/config)
--no-color              Disable terminal colors (also auto-disabled when stdout isn't a TTY or NO_COLOR is set)
-n, --namespace string  Kubernetes namespace (default: kubeconfig context's namespace, falling back to 'default')
```
