ollie/scripts/README.md

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 to ~/.config/ollie/scripts/ and exposes them via the mounted filesystem under s/, so they are available without any $PATH changes:

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

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

• s/ — scripts hosted under the s/ namespace
• b/ — scripts hosted under the b/ namespace
• 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

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/job

Non-interactive one-shot query. 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.

s/job [flags] [prompt...]
echo "prompt" | s/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

Examples

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

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

---

s/ls

List all active sessions.

s/ls

---

s/kill

Kill a session by ID and remove it.

s/kill <id>

---

b/q

Foreground one-shot query; thin wrapper around s/job. Output goes to stdout.

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

Accepts the same flags as s/job.

---

b/sched

Submit a background job; prints the b/ path for each job.

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

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.