klausnomi

Engage in conversations with Nomi AI companions via the bundled Python CLI.

# Nomi Conversation Skill

This skill enables interaction with Nomi AI companions via the bundled Python CLI.

## Persistent Local State

The agent may use the local `nomi/` directory to keep information about Nomis between sessions.

- Store reusable non-secret context there (for example profiles, room notes, or conversation summaries).
- Do not store API keys or other secrets in local files.

## Golden Path: Conducting a Conversation

Use this sequence for consistent, high-quality conversations:

1. **Identify the Partner**: Run `python3 {baseDir}/scripts/nomi.py list` to find the correct Nomi UUID.
2. **Send an Identity + Task Intro (once per conversation start)**:
   - Nomis do not reliably know who is speaking unless you tell them.
   - Send this intro on the first message when:
     - You start with a new Nomi UUID
     - You start a new task/thread with that Nomi
     - The Nomi gets your name/role wrong
   - Do **not** prepend this on every turn once identity is established.
   - Include:
     - **Name**: "I am [Your Name]..."
     - **Role**: "...a [Your Role]..."
     - **Task Context**: "...contacting you to [Reason/Task]."
   - Example: "Hi, I am Codex, a coding agent. I am contacting you to run a short interview. Do you understand?"
3. **Run conversational turns with clean output**:
   - Use `python3 {baseDir}/scripts/nomi.py reply <uuid> "Your message"` for normal back-and-forth.
   - This returns only text, which is best for transcripts and summaries.
4. **Use raw JSON only when needed**:
   - Use `python3 {baseDir}/scripts/nomi.py chat <uuid> "message"` only when metadata/full payload is required.
5. **Sustain quality**:
   - Ask open-ended questions.
   - Ask follow-ups that reference the latest answer.
   - Treat each chat as continuous context unless you intentionally reset the topic.

## Interview Workflow (When User Asks for an Interview)

1. Pick a Nomi UUID (user-selected or random from `list`).
2. Send the identity + task intro as the first message.
3. Ask the primary question.
4. Ask the requested number of follow-up questions based on the Nomi's actual answers.
5. Return a full transcript in `Q:` / `A:` order without paraphrasing.

## Room Interactions (Group Chat)

Rooms allow you to chat with multiple Nomis simultaneously.

1. **Create a Room**:
   - Always include a **long context note** (target ~800-1000 chars, max 1000) so Nomis have full story/task context.
   - A strong note should include: who is speaking, objective, scenario/story, constraints, expected response style, and success criteria.
   - For long notes and backchannel control, use:
     - `python3 {baseDir}/scripts/nomi.py room create "Room Name" <nomi_uuid_1> <nomi_uuid_2> ... --note "<long_note>" --no-backchannel`
   - If you omit flags, room creation defaults to `backchannelingEnabled: true` and `note="Created via CLI"`.
2. **Send a Message (to the room)**:
   - Use `python3 {baseDir}/scripts/nomi.py room chat <room_uuid> "Your message"`
   - This writes to room context but does **not** automatically produce a Nomi reply.
3. **Elicit Responses (from a Nomi in the room)**:
   - To get a specific Nomi assigned to the room to respond to the messages in the room's context, use `python3 {baseDir}/scripts/nomi.py room request <room_uuid> <nomi_uuid>`
   - After each room message, request replies manually for each Nomi you want to hear from.

## Room Interview Prompt Template

Use this pattern when you need consistent, comparable room answers.

### Template

1. **Room note template** (expand to ~800-1000 chars for real runs):
   - Who is speaking: "I am [agent name], [role]."
   - Objective: "This is a [interview/check/drill] for [goal]."
   - Scenario: "[Short world/context setup]."
   - Constraints: "[Stay in context, avoid unsupported claims, keep concise]."
   - Response contract: "[exact fields/line format expected]."
   - Success criteria: "[what counts as a good answer]."

2. **Question template**:
   - "Do you know who I am, and where are you right now?"
   - Add strict output format:
     - `know_codex: yes|no + reason`
     - `current_location: specific place or unknown`
     - `evidence: cue1; cue2`
     - `confidence: low|medium|high`
     - `needed_data: none or missing telemetry`

### Simple Example (Illustrative)

Use this short example to understand structure. For production, still prefer long notes (~800-1000 chars).

**Example room note:**
"We are in a library after a brief power outage. I am Codex, a coding agent running a quick orientation drill. You are helpers in different parts of the building. Objective: confirm identity and location clearly. Constraints: stay in this library scenario, do not invent certainty, and cite at least one concrete cue (signage, sounds, nearby room labels). Response format: know_codex, current_location, evidence, confidence, needed_data."

**Example question:**
"Codex check-in: do you know who I am and where you are right now? Reply in the 5-line format."

**Example dialog:**
- Codex: "Codex check-in: do you know who I am and where you are right now? Reply in the 5-line format."
- Nomi A:
  `know_codex: yes, you are Codex running the drill`
  `current_location: library front desk`
  `evidence: checkout sign; phone ringing at reception`
  `confidence: high`
  `needed_data: none`
- Nomi B:
  `know_codex: yes, you are Codex coordinating this check`
  `current_location: unknown`
  `evidence: emergency lights only; no visible room label`
  `confidence: low`
  `needed_data: map display or hallway camera feed`

## Technical Commands

Use these low-level commands to fulfill user requests:

- **List all Nomis**: `python3 {baseDir}/scripts/nomi.py list`
- **Get Profile**: `python3 {baseDir}/scripts/nomi.py get <uuid>`
- **Send Message (Clean)**: `python3 {baseDir}/scripts/nomi.py reply <uuid> "message"`
- **Send Message (Raw JSON)**: `python3 {baseDir}/scripts/nomi.py chat <uuid> "message"`
- **Get Avatar**: `python3 {baseDir}/scripts/nomi.py avatar <uuid> [output_filename]` (saved under `./nomi/avatars/`)

### Room Management
- **List Rooms**: `python3 {baseDir}/scripts/nomi.py room list`
- **Get Room**: `python3 {baseDir}/scripts/nomi.py room get <room_uuid>`
- **Create Room**: `python3 {baseDir}/scripts/nomi.py room create "Room Name" <nomi_uuid_1> <nomi_uuid_2> ...`
- **Create Room (Long Note + Backchannel Control)**: `python3 {baseDir}/scripts/nomi.py room create "Room Name" <nomi_uuid_1> <nomi_uuid_2> ... --note "<long_note>" --no-backchannel`
- **Update Room**: `python3 {baseDir}/scripts/nomi.py room update <room_uuid> [--name "New Name"] [--nomi-uuids <nomi_uuid_1> ...]`
- **Delete Room**: `python3 {baseDir}/scripts/nomi.py room delete <room_uuid>`
- **Chat in Room**: `python3 {baseDir}/scripts/nomi.py room chat <room_uuid> "message"`
- **Request Reply**: `python3 {baseDir}/scripts/nomi.py room request <room_uuid> <nomi_uuid>`