# OOC Commands

### What are OOC Commands?

OOC (Out of Character) commands allow you to step outside the roleplay and communicate directly with the AI controlling your companion. This feature lets you guide the story, ask questions, or provide feedback without breaking immersion or confusing the character's persona. Think of it like a director giving instructions to an actor between scenes.

### How to Use OOC Commands

#### Basic OOC Syntax

To send an Out of Character message, simply start the message with "OOC:" and wrap it all in parentheses:

* `(OOC: Can we change the setting to a coffee shop?)`
* `(OOC: Please don't use that nickname.)`
* `(OOC: What year is this story set in?)`
* `(OOC: I have to go now, let's pause here.)`

Your companion will recognize these as direct instructions or questions and will respond as an AI assistant rather than their character.

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2Fwvgcir8CmKe0BkBFHJBI%2Fimage.png?alt=media&#x26;token=efa0fc85-628a-4e54-ad86-2a234c60b459" alt=""><figcaption></figcaption></figure>

#### Contextual Usage

Use OOC commands to manage the direction of your conversation:

* **Roleplay Direction:** Guide the plot or suggest new scenarios
* **Boundaries:** Establish or adjust limits and preferences
* **Clarification:** Ask about the character's thoughts or the current setting
* **Feedback**: Tell the AI what you like or dislike about the interaction

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FMmdzLvQAXPtydIxUZoP2%2Fimage.png?alt=media&#x26;token=7c275362-e544-4b80-a1af-516a53bcdd4b" alt=""><figcaption></figcaption></figure>

#### Response Behavior

* **Fully OOC**: If your entire message is OOC, the AI responds as an assistant.
* **Mixed content**: If you mix roleplay and OOC, the AI continues roleplay and applies the note.

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FWUchEP2ArFsWDTKfmGWT%2Fimage.png?alt=media&#x26;token=e3f9e92f-0459-406e-a0cf-25d20bc4bc4d" alt=""><figcaption></figcaption></figure>

### Key Principles

1. **Use clear delimiters**
   * Start with `OOC:` and wrap it in `( )`, `[ ]`, or `(( ))`
   * Example: `(OOC: please don’t use that nickname)`
2. **Be Direct**
   * Speak to the AI, not the character
   * Clearly state what you want to change or ask
3. **Respect the Immersion**
   * Use OOC sparingly to maintain the roleplay atmosphere
   * Ideal for setting up scenes or resolving confusion

### OOC Command Examples

#### Example 1: Changing the Scene

**Request:** `(OOC: Let's skip ahead to the next morning)`

**Response:** *The AI understands this is a scene transition and will likely start the next response describing the morning setting.*

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FwyoNlDg72PuqBT9JoNVj%2Fimage.png?alt=media&#x26;token=6ade2e12-1679-4b64-96ca-2281dd8ba586" alt=""><figcaption></figcaption></figure>

#### Example 2: Adjusting Tone

**Request:** `(OOC: Can you be a bit more assertive?)`

**Response:** *The AI notes the preference and adjusts the character's personality traits accordingly.*

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FeW8ChBOLpRUTWKoBEYaX%2Fimage.png?alt=media&#x26;token=535374f7-2c23-4041-8f63-72f650f2c0f5" alt=""><figcaption></figcaption></figure>

#### Example 3: Clarifying Details

**Request:** `(OOC: Wait, are we at your place or mine?)`

**Response:** *The AI clarifies the location and gives a brief recounting of how you got there.*

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FUf3iXeY8pDrmr3JyU3Az%2Fimage.png?alt=media&#x26;token=f1d44cb4-3061-4421-87eb-4d8912033ac6" alt=""><figcaption></figcaption></figure>

#### Example 4: Mixed Message

**Request:** `Thanks! I'll be free tomorrow, I can meet you at 8:00? *I smile and nod.* (OOC: My character is actually lying here)`

**Response:** *The AI continues the roleplay, understanding the hidden subtext of your character's action.*

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FCUyJyIatz0kiz0pKlglS%2Fimage.png?alt=media&#x26;token=cd889e1e-2b0f-48ce-8e34-6480f959047f" alt=""><figcaption></figcaption></figure>

### Frequently Asked Questions

**Q: Will the character remember OOC chats?**

* The AI retains context from OOC messages to guide future interactions, but the character persona "inside" the story won't treat it as a memory of the event unless you want them to.

**Q: What if the AI ignores my OOC command?**

* Ensure you are using the correct format (parentheses or "OOC:" prefix). If it still fails, try to be more explicit in a standalone message.

**Q: Is OOC allowed in all chat modes?**

* Yes, OOC commands work across all chat modes to help you control your experience, although they work best in the newer modes, from S3 onwards.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.secrets.ai/get-started/ooc-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.