# Verified CLI adapter notes

This reference captures concrete adapter shapes that were exercised while building a local GUI wrapper for agents.

## Verified on this machine

### Claude Code

The following non-interactive command worked from the project directory:

```bash
claude -p --output-format text --permission-mode default "Reply with exactly: pong"
```

Observed result: `pong`

Use this as the default CLI adapter shape for Claude Code in a local GUI wrapper when the user wants a simple one-shot backend.

### Hermes

The local Hermes CLI is available on this machine and the project configuration used this one-shot shape:

```bash
hermes chat -q "{prompt}"
```

Use this as the basic adapter shape when Hermes is exposed through a local GUI.

## Adapter guidelines

- Keep the command as argv, not a shell string.
- Replace placeholders like `{prompt}` before spawning the process.
- Prefer an echo/noop adapter for smoke tests and offline demos.
- Keep timeout handling explicit in the config.
- Store only normalized events in the session history.

## Visual/UI notes

The successful UI direction for this session was:
- pixel-art office layout
- animated walking characters in the scene
- selected agent highlighted in the crew panel
- central canvas for the office scene
- chat kept in a separate panel so the scene can stay readable

This is a good baseline for future refinements such as sprites, per-agent skins, and richer movement states.