# scripts

Shell scripts for interacting with the ollie 9P filesystem.
All scripts read `OLLIE` (default: `$HOME/mnt/ollie`) for the mount path.

`mk scripts` installs them and exposes them via the mounted filesystem,
so they are available without any `$PATH` changes:

```sh
exec $OLLIE/s/sh              # start interactive shell
$OLLIE/s/ls                   # list sessions
$OLLIE/s/kill <id>            # kill a session
$OLLIE/b/job "my prompt"      # submit and wait for a batch job
$OLLIE/b/q "my prompt"        # foreground one-shot query
$OLLIE/b/sched "my prompt"    # submit a background job; prints b/ path
$OLLIE/u/optimize "prompt"    # generate and return best optimized prompt
```

Scripts are organized by the filesystem namespace they are hosted under:

- `s/` — session management scripts
- `b/` — batch job scripts
- `u/` — utility scripts; compositions of other ollie primitives

---

## s/sh

Interactive chat interface for ollie sessions. Resumes the most recent
session for the current directory by default; creates a new one if none
exists.

```
s/sh [-new] [-resume] [-session ID] [-cwd DIR] [-backend B] [-model M] [-agent A]
```

**Flags**

| Flag | Description |
|---|---|
| `-new` | Always create a new session |
| `-resume` | Resume last session for the cwd; error if none |
| `-session ID` | Attach to a specific session by ID |
| `-cwd DIR` | Working directory (default: `pwd`) |
| `-backend B` | Backend override (e.g. `ollama`, `anthropic`) |
| `-model M` | Model override |
| `-agent A` | Agent config name |

**Input**

At the `>` prompt:

| Input | Action |
|---|---|
| `<text>` | Submit prompt, stream response |
| `/q <text>` | Enqueue prompt for later |
| `/<cmd>` | Send to session ctl (e.g. `/compact`, `/clear`) |
| `/kill` | Kill the session and exit |
| Ctrl-C | Interrupt running turn (or exit if idle) |

**Examples**

```sh
s/sh                          # resume or create session for pwd
s/sh -new -model gpt-4o       # fresh session with model override
s/sh -session 1745123456-abc  # attach to a specific session
```

---

## s/ls

List all active sessions.

```
s/ls
```

---

## s/kill

Kill a session by ID and remove it.

```
s/kill <id>
```

---

## b/job

Core batch job runner. Submits a prompt to `b/new`, waits for completion,
prints the result to stdout, then removes the job. Exit code is non-zero on
failure. `b/q` and `b/sched` are both wrappers around this script.

```
b/job [flags] [prompt...]
echo "prompt" | b/job [flags]
```

**Flags**

| Flag | Description |
|---|---|
| `-name N` | Base job name; jobs are suffixed `-0`, `-1`, ... |
| `-cwd DIR` | Working directory (default: `pwd`) |
| `-agent A` | Agent config name |
| `-backend B` | Backend override |
| `-model M` | Model override |
| `-output json` | Append JSON-only instruction to prompt |
| `-parallel N` | Run the same prompt N times in parallel (default: 1) |
| `-keep` | Do not remove job(s) after printing result |
| `-bg` | Submit and exit immediately; prints job id(s); implies `-keep` |

**Examples**

```sh
b/job "Summarize this repo in one sentence"
cat error.log | b/job "What is causing this error?"
b/job -output json "List the top 3 risks as JSON"
b/job -parallel 4 -keep "Write a haiku about filesystems"
b/job -backend ollama -model qwen3:8b "Explain this function" < main.go
```

With `-parallel N` and N > 1, results are separated by `=== {id} ===` headers.

---

## b/q

Foreground one-shot query; thin wrapper around `b/job`. Accepts the same flags.

```
b/q [flags] [prompt...]
echo "prompt" | b/q [flags]
```

---

## b/sched

Submit a background job; prints the `b/` path for each job. Wrapper around
`b/job -bg`.

```
b/sched [flags] [prompt...]
echo "prompt" | b/sched [flags]
```

**Flags**

| Flag | Description |
|---|---|
| `-name N` | Base job name |
| `-cwd DIR` | Working directory (default: `pwd`) |
| `-agent A` | Agent config name |
| `-backend B` | Backend override |
| `-model M` | Model override |
| `-output FORMAT` | Output format hint (e.g. `json`) |
| `-parallel N` | Submit N parallel jobs (default: 1) |

---

## u/optimize

Generates N candidate optimized prompts, judges them, and returns the best
one to stdout. Debugging output (progress messages) goes to stderr.

```
u/optimize [flags] [prompt...]
echo "prompt" | u/optimize [flags]
```

**Flags**

| Flag | Description |
|---|---|
| `-n N` | Number of candidates to generate (default: 3) |
| `-cb B` | Candidate generation backend |
| `-cm M` | Candidate generation model |
| `-jb B` | Judge backend |
| `-jm M` | Judge model |

**Examples**

```sh
u/optimize "Summarize this document"
u/optimize -n 5 -cm qwen/qwen3-8b -jm anthropic/claude-opus-4.6 "Write a haiku"
u/optimize "generate a hello world program. use c++." >[2]/dev/null | b/q
```

Outputs to stdout, making it composable with other pipeline stages.