Files
penguin-harness/packages/cli/README.md
T
Yaowei Zheng 4fa2eef446 Serve the site from the penguin.ooo apex domain
Set the Pages workflow BASE_PATH to / (assets 404ed on the custom domain under the /<repo>/ subpath) and point all hardcoded site links at https://penguin.ooo.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018ihk8iQuo3kv2aPjAYEPuR
2026-07-19 15:05:47 +08:00

1.7 KiB

@prismshadow/penguin-cli

The PenguinHarness command line. Installs the penguin command: an interactive REPL, a one-shot task runner, model / vault configuration, and the launcher for the Web service.

npm install -g @prismshadow/penguin-cli   # requires Node >= 24
penguin web        # start the Web service and open http://127.0.0.1:7364
penguin server     # same service, headless

penguin config model add --model-id deepseek-v4-pro --api-key sk-... --set-default

penguin run -m "Create hello.txt containing Hello, Penguin"    # one Task, then exit
penguin chat                                                   # REPL: /compact, /exit, Ctrl-C interrupts
penguin chat --resume                                          # resume the latest session

Tool calls go through an approval gate — --approve allow-all (default) | deny-all | read-only | always-ask. Data lives under ~/.penguin/data (PENGUIN_HOME or --root override); model credentials come from the Project config or provider env vars (e.g. DEEPSEEK_API_KEY).

Prefer a one-line install with a bundled Node runtime? See the installation guide.

Documentation

Development

pnpm penguin <args>                              # run from source (repo root, via tsx)
pnpm --filter @prismshadow/penguin-cli build     # tsup → dist/index.js (the penguin bin)
pnpm --filter @prismshadow/penguin-cli typecheck
pnpm --filter @prismshadow/penguin-cli test

Part of PenguinHarness · Apache-2.0