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

# External-agent writing

> The preferred workflow when Codex, Claude Code, Cursor, or another agent writes the article.

This is the default path for coding agents.

## 1. Load context

```bash theme={null}
aeo agent context
aeo strategy show
aeo visibility show
aeo metrics overview
```

If the task depends on a specific source, read it lazily:

```bash theme={null}
aeo drive list
aeo drive read <file_id>
```

## 2. Draft locally

Write the article in your own workspace. Use the same dashboard-visible context that Aeolo uses for the brand.

## 3. Import

```bash theme={null}
aeo content import \
  --title "..." \
  --body-file ./draft.md
```

The imported draft is created in review state. Use `aeo content update <id> --status draft|review|approved` only when the user wants that lifecycle state changed.

## 4. Review

```bash theme={null}
aeo content review <content_id>
```

The review step should produce concrete fixes. Apply only the fixes that improve the article.

## 5. Update and preview

```bash theme={null}
aeo content update <content_id> --body-file ./draft.final.md
aeo content preview <content_id>
```

`content preview` creates or reuses a public, unauthenticated preview URL. Generate one only when the draft can be shared outside the authenticated workspace.

## 6. Deploy

```bash theme={null}
aeo content deploy <content_id>
```

Deploy only after the user approves the final draft and destination. The content must be `approved` first:

```bash theme={null}
aeo content update <content_id> --status approved
aeo content deploy <content_id>
```