# Use Cases and Recipes
> Source: https://useagentos.dev/docs/core/use-cases

Use this page when you know what you want AgentOS to do, but you are not
sure which feature guide to read first.

## First Successful Run

Goal: install AgentOS, configure one provider, and send a real message.

```sh
agentos onboard
agentos gateway run
```

Then open:

```text
http://127.0.0.1:18791/control/
```

If you prefer the terminal:

```sh
agentos chat
```

Read next:

- [Quickstart](https://useagentos.dev/docs/core/quickstart)
- [Web UI](https://useagentos.dev/docs/core/web-ui)
- [Providers and Models](https://useagentos.dev/docs/core/providers-and-models)

## Reduce Model Cost

Goal: keep simple work on cheaper models and reserve stronger models for hard
turns.

```sh
agentos configure router --router recommended
agentos cost --by-model
```

Use diagnostics when you want to inspect routing and runtime behavior:

```sh
agentos diagnostics on
```

Read next:

- [Pilot Router](https://useagentos.dev/docs/core/features/pilot-router)
- [Tool Compression](https://useagentos.dev/docs/core/features/tool-compression)
- [Compaction and Cache Continuity](https://useagentos.dev/docs/core/features/compaction-and-cache)

## Work With Large Tool Results

Goal: let the agent inspect logs, pages, tables, search results, or diffs
without flooding the model context.

Start with a bounded workspace run:

```sh
agentos agent \
  --workspace /path/to/project \
  --workspace-strict \
  -m "Inspect the latest logs and summarize the actionable failures"
```

If the turn seems too slow or expensive:

```sh
agentos cost
agentos diagnostics on
```

Read next:

- [Tool Compression](https://useagentos.dev/docs/core/features/tool-compression)
- [Tools, Approvals, and Sandbox](https://useagentos.dev/docs/core/tools-and-sandbox)
- [Troubleshooting](https://useagentos.dev/docs/core/troubleshooting)

## Build a Repeatable Workflow

Goal: turn recurring work into reusable skills.

Find an existing skill:

```sh
agentos skills search report
agentos skills view <skill-name>
```

Read next:

- [Skills](https://useagentos.dev/docs/core/features/skills)
- [Artifacts and Media](https://useagentos.dev/docs/core/artifacts-and-media)

## Remember Useful Context

Goal: preserve preferences, project notes, or reusable task context so future
turns can find them.

```sh
agentos memory status
agentos memory search "project preference"
agentos memory list
```

Inspect a stored memory file:

```sh
agentos memory show <path>
```

Read next:

- [Memory](https://useagentos.dev/docs/core/features/memory)
- [Compaction and Cache Continuity](https://useagentos.dev/docs/core/features/compaction-and-cache)

## Connect a Messaging Channel

Goal: use AgentOS from a supported messaging surface while keeping the
gateway as the local control point.

```sh
agentos channels types
agentos channels describe telegram
agentos channels add telegram --name personal
agentos gateway restart
agentos channels status personal --json
```

Read next:

- [Channels](https://useagentos.dev/docs/core/channels)
- [Configuration](https://useagentos.dev/docs/core/configuration)
- [Tools, Approvals, and Sandbox](https://useagentos.dev/docs/core/tools-and-sandbox)

## Schedule Recurring Work

Goal: ask AgentOS to run a recurring task without manually opening a chat.

```sh
agentos cron add \
  --every 1h \
  --text "Summarize important project updates" \
  --name hourly-project-check
```

Inspect jobs and runs:

```sh
agentos cron list
agentos cron status <job-id>
agentos cron runs <job-id>
```

Read next:

- [Operations](https://useagentos.dev/docs/core/operations)
- [Channels](https://useagentos.dev/docs/core/channels)
- [Scheduling](https://useagentos.dev/docs/core/scheduling)

## Publish a User-Visible Artifact

Goal: ask the agent to produce a file, report, slide deck, HTML page, image, or
media asset that you can inspect and share.

```sh
agentos agent -m "Create a short HTML report from the current notes"
agentos sessions export <session-key>
```

Read next:

- [Artifacts and Media](https://useagentos.dev/docs/core/artifacts-and-media)
- [Skills](https://useagentos.dev/docs/core/features/skills)

## Recover From a Bad Run

Goal: understand what happened, reduce risk, and continue safely.

```sh
agentos doctor
agentos gateway status
agentos sessions show <session-key>
agentos cost
```

If a tool was denied or the agent had too much access:

```sh
agentos sandbox status
agentos agent --permissions restricted -m "Read only"
```

Read next:

- [Troubleshooting](https://useagentos.dev/docs/core/troubleshooting)
- [Tools, Approvals, and Sandbox](https://useagentos.dev/docs/core/tools-and-sandbox)
- [Approvals and Permissions](https://useagentos.dev/docs/core/approvals-and-permissions)
- [Diagnostics and Replay](https://useagentos.dev/docs/core/diagnostics-and-replay)
- [Operations](https://useagentos.dev/docs/core/operations)
