---
url: https://docs.mochiexec.io/reference/cli/mochi_ai_document.md
description: Generate descriptions for a workspace's undescribed executables
---

# mochi ai document

Generate descriptions for a workspace's undescribed executables

## Synopsis

Generates a one-line description for every executable in a workspace that does not have one. Prints them for review by default; --write sets the description field in each flow file, leaving the rest of the file untouched. Defaults to the current workspace.

```shell
mochi ai document [workspace] [flags]
```

## Options

| Flag | Type | Description |
|------|------|-------------|
| `-h, --help` |  | help for document |
| `-n, --limit` | `int` | Maximum number of executables to describe (0 for all) |
| `-o, --output` | `string` | Output format: text or json (default "text") |
| `--overwrite` |  | Include executables that already have a description |
| `--write` |  | Write each description into its flow file |

## Options inherited from parent commands

| Flag | Type | Description |
|------|------|-------------|
| `-L, --log-level` | `string` | Log verbosity level (debug, info, fatal) (default "info") |
| `--sync` |  | Sync flow cache and workspaces |

## See also

* [mochi ai](mochi_ai.md) — Describe, explain, and diagnose executables with AI