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

# Refine post copy

> Use the Writing Assistant in the web editor.

The Writing Assistant refines one Post body item in the web editor. You can
manage its Workspace settings in the web app, public API, or CLI.

## Refine the copy

1. Open a Post in the web editor.
2. Click the sparkles icon below the body field.
3. Select a refinement option.

OpenPMM shows a comparison between the source copy and the refined copy. Select
**Accept** to use the refined copy. Select **Reject** to keep the source copy.

The Workspace starts with these refinement options:

* **Fix grammar**
* **Improve writing**
* **Make it punchier**
* **Condense**
* **Rephrase / Mix it up**
* **Expand & elaborate**
* **Improve structure & spacing**

The built-in options keep facts, links, mentions, hashtags, and the source
language. They also remove common machine-written patterns.

A Workspace member can change the title, prompt, and icon for each option.

## Use a custom prompt

Type an instruction in the search field. Press **Enter**, or select **Use
custom prompt**.

OpenPMM applies the custom instruction and the channel rules. It does not apply
the built-in humanization rules or the Workspace option settings.

## Use channel-aware copy

The Writing Assistant uses the rules for the selected channel.

* X copy uses short sentences and a strong opening.
* LinkedIn copy uses useful opening lines and short paragraphs.
* Threads copy uses a direct and conversational style.
* Bluesky copy stays concise and respects its text limit.
* Mastodon copy uses the limit from the selected destination.
* Other channels use their native body format and text limit.

The Writing Assistant refines only the selected body item. It does not create
new thread items or change a YouTube title.

## Refine synced copy

A synced follower channel cannot use the Writing Assistant. Unsync that channel
before you refine its copy.

You can refine the master channel. OpenPMM sends the exact result to each
compatible synced channel through the normal sync rules. It does not create a
separate channel-specific result for a synced follower.

## Customize Workspace options

The AI Refine settings apply to all members of the Workspace.

1. Click the cog in the Writing Assistant menu.
2. Change the **Title** field to change the menu label.
3. Change the **Prompt template** field to change the refinement action.
4. Click the icon button to open the icon picker.
5. Select one of the 30 icons.
6. Click **Save**.

You can change all seven options. For example, you can change **Fix grammar** to
**Translate to German**. The prompt must tell OpenPMM to translate the copy.

Click **Reset** for an option to restore its default title, prompt, and icon.
Click **Save** to save the reset.

Changing a setting does not change existing body text. The setting applies the
next time a Workspace member selects the option.

### Manage options through the API or CLI

Use `GET /v1/workspaces/{workspace_id}/writing-refinement-settings` to read the
effective settings. The response always includes all seven stable action keys,
including default values that the Workspace has not changed.

Use `PUT /v1/workspaces/{workspace_id}/writing-refinement-settings` to replace
the complete settings. Send the ETag from the GET response in `If-Match`. The
request must include all seven actions. Each action requires a `title`,
`prompt`, and supported `icon` key.

The CLI performs the same workflow:

```bash theme={null}
openpmm writing-assistant settings show --workspace ws_... --json
openpmm writing-assistant settings update \
  --workspace ws_... \
  --file writing-assistant-settings.json \
  --json
```

The update command reads the current ETag automatically. Pass `--etag` when a
script must update only the exact version that it read earlier.

## Review the system prompt

The settings dialog includes a **System prompt** information icon. Point to the
icon or move keyboard focus to it to read the system prompt.

The system prompt shows the source rules, channel guidance, content limit, and
humanization rules. It also shows where OpenPMM adds your prompt template.

Click the information icon to keep the system prompt open on a touch device.

You cannot change the source rules, output format, or channel limits. A custom
prompt does not use the humanization rules.