Quick Start

# Create files and directories
mkdir -p ~/project/src
echo 'Hello from Shiro' > ~/project/README.md

# List and search
ls -la ~/project
find ~/project -name "*.md"

# Pipes and redirects
echo "hello world" | sed 's/hello/goodbye/' | wc -c

# Files persist across reloads
cat ~/project/README.md

# Create, copy, move, remove
touch file.txt
cp file.txt backup.txt
mv backup.txt renamed.txt
rm renamed.txt

# Directory operations
mkdir -p deep/nested/path
rmdir empty-dir
rm -r deep

# Permissions (stored but not enforced)
chmod 755 script.sh
ls -l script.sh

# Symbolic links
ln -s /home/user/target /home/user/link
readlink /home/user/link

# Disk usage
du -sh /home/user

# Pipe output between commands
ls -la | grep ".js" | wc -l

# Redirect to file
echo "hello" > output.txt
echo "more" >> output.txt    # append

# Input redirect
cat < output.txt

# Stderr redirect
command-that-fails 2> errors.txt

# Set and use variables
NAME="Shiro"
echo "Welcome to $NAME"
echo "Home is ${HOME}"

# Built-in variables
echo $HOME          # /home/user
echo $SHELL         # /bin/sh
echo $?             # last exit code

# Export for child processes
export API_KEY=abc123

# AND — run next only if previous succeeds
mkdir -p /tmp/test && echo "created"

# OR — run next only if previous fails
cat /nonexistent 2>/dev/null || echo "file not found"

# Semicolons — run sequentially regardless
echo "first" ; echo "second" ; echo "third"

# Single quotes — literal, no expansion
echo '$HOME is not expanded'

# Double quotes — variables expanded
echo "Home is $HOME"

# Backslash escapes
echo "line one\nline two"

# Initialize a project
mkdir -p ~/myapp && cd ~/myapp
npm init -y

# Install packages (real tarballs from registry.npmjs.org)
npm install lodash
npm install -g prettier

# Use in scripts
node -e "console.log(require('lodash').uniq([1,1,2,3]))"

# Run a script file
echo 'const _ = require("lodash"); console.log(_.chunk([1,2,3,4,5,6], 2));' > app.js
node app.js

# npm scripts
npm run start

# Package management
npm list
npm uninstall lodash

# npx — run package binaries (auto-installs if needed)
npx prettier --write app.js
npx typescript --version
npx @scope/pkg arg1 arg2

# Bundle TypeScript/JavaScript
build src/app.ts --bundle --outfile=dist/app.js

# Set your API key
export ANTHROPIC_API_KEY=sk-ant-...

# Ask a question
spirit "explain how DNS works"

# Pipe data through AI
cat data.csv | spirit "summarize this data"

# Generate code
spirit "write an Express API with /users endpoint" > server.js

# Use a specific model
spirit --model claude-opus-4-20250514 "review this code" < app.js

# Set a system prompt
spirit --system "You are a bash expert" "how do I find large files?"

# List available models
spirit --list-models

echo '#include <stdio.h>
int main() { printf("Hello from C!\\n"); return 0; }' > hello.c
cc hello.c -o hello
./hello

sqlite3 app.db "CREATE TABLE users (name TEXT, age INTEGER);"
sqlite3 app.db "INSERT INTO users VALUES ('Alice', 30), ('Bob', 25);"
sqlite3 app.db "SELECT * FROM users WHERE age > 28;"
sqlite3 app.db ".tables"

python3 -c "print('Hello from Python!')"
python3 -c "import json; print(json.dumps({'key': 'value'}, indent=2))"

# Run a script
echo 'for i in range(5): print(f"Count: {i}")' > count.py
python3 count.py

lua -e "print('Hello from Lua!')"
lua -e "for i=1,5 do print(i) end"

echo '{"name":"Alice","scores":[95,87,92]}' | jq '.scores | add / length'
echo '[1,2,3,4,5]' | jq 'map(. * 2)'

# Initialize and make commits
git init
echo "# My Project" > README.md
git add .
git commit -m "Initial commit"

# Make changes and diff
echo "Updated" >> README.md
git diff
git add . && git commit -m "Update readme"

# View history
git log --oneline
git status

# Clone a repo (HTTP only, needs CORS proxy)
git clone https://github.com/user/repo.git

# Push (needs GITHUB_TOKEN)
GITHUB_TOKEN=$GITHUB_TOKEN git push origin main

# Sign in (opens OAuth flow)
setup

# Print mode — one-shot code generation
claude -p "Write a function that checks if a number is prime"

# Pipe input for analysis
cat app.js | claude -p "Review this code for bugs"

# Interactive mode (opens in a terminal window)
sc

# CodeMirror editor (lightweight)
code app.js

# Monaco editor (VS Code engine)
monaco app.ts

# Auto-detect: open picks editor by extension
open app.js        # opens in code editor

# View a markdown file
mdview README.md

# Pipe markdown content
echo '# Hello World
- item one
- item two

```js
console.log("highlighted!")
```' | mdview

# open auto-detects .md files
open notes.md      # renders with mdview

# Render HTML in a window
echo '<h1>Hello</h1>' | html
html page.html

# Display an image
img screenshot.png

# Text-to-speech
echo "Hello world" | speak
speak -r 1.5 "Fast speech"
speak --list                  # list voices

# Speech-to-text
listen                        # single utterance to stdout
listen | sh                   # speak a command to execute it
listen -c >> notes.txt        # dictate continuously

# Desktop notifications
build && notify "Build complete"
notify -t "Alert" "Check this"

# Webcam snapshot
camera -o selfie.png
camera && img camera-*.png

# Computer vision (camera → Claude AI)
camera | cv "describe this"
cv -f photo.png "what's in this image?"

# Process monitor
top                           # interactive TUI (q to quit)
top -b -n 1                   # batch mode, one snapshot

# Manual pages
man grep                      # full man page in less pager
man -k search                 # search all descriptions

# Start a server
serve /tmp/myapp 3000

# Interact with the page
page :3000 text "body"           # read text
page :3000 click "#button"       # click an element
page :3000 input "#name" "Alice" # type into input
page :3000 eval "document.title" # run JavaScript

# Split view — dock app beside the terminal
serve /tmp/myapp 3000 --split right
serve open 3000 --split bottom
serve unsplit

# Full-screen app mode
become 3000 myapp    # URL becomes /myapp
unbecome             # return to terminal

remote start     # Generate connection code
remote status    # Check connection
remote stop      # End session

{
  "mcpServers": {
    "shiro": { "command": "shiro-mcp" }
  }
}