serve(1)

💅 serve(1) — the General Commands Manual, but make it cute

okay bestie, so this is the manual page for serve from the General Commands Manual — yes, that one, the whole collection. buckle up 🎀

---

✨ NAME ✨

serve — spin up the ACP server over HTTP and WebSocket, no cap 🫶

---

🌸 SYNOPSIS 🌸

serve [--host] [--port] [--tls] [--tls-cert-path] [--tls-key-path]
[--platform] [--with-builtin] [--dangerously-unauthenticated]
[--allowed-origin] [--enable-scheduler] [-h|--help]

like, that's the whole vibe in one block 💖

---

🦋 DESCRIPTION 🦋

Start the ACP server over HTTP and WebSocket. that's it, that's the tea ☕ main character energy, honestly 🔥

---

👑 OPTIONS 👑

okay here's the part you actually came for, bestie — every single flag, nothing skipped 💅

• --host <HOST> [default: 127.0.0.1] — which host you're binding to. defaults to 127.0.0.1, so it's staying cozy on loopback unless you say otherwise 🏠
• --port <PORT> [default: 3284] — the port it listens on, and the default is 3284 fr fr 🔢
• --tls — serve ACP over TLS. security era 🔒✨
• --tls-cert-path <PATH> — where your TLS cert lives, path-style 🎀
• --tls-key-path <PATH> — and where the TLS key lives 🗝️
• --platform <PLATFORM> [default: cli] — picks the platform, default cli. possible values, literally only these two:
  • cli
  • desktop
• --with-builtin <NAME> — adds one or more builtin extensions that are bundled with goose, by specifying their names comma-separated. yes you can stack 'em 🧚
• --dangerously-unauthenticated — starts the ACP endpoint without requiring GOOSE_SERVER__SECRET_KEY. bestie the flag literally has "dangerously" in the name, so like… be so for real before you run this one 🙈💀
• --allowed-origin <ORIGIN> — allows an exact Origin value for ACP CORS. you can pass it multiple times, and heads up: it replaces the default loopback origins — not adds to, replaces 👀🔥
• --enable-scheduler — turns on scheduled recipe execution ⏰🍓
• -h, --help — prints help. and if you use -h it gives you a summary version (yep, -h and --help are not identical, iykyk) 💜

---

🌈 SEE ALSO 🌈

the whole friend group, in order, no one left out 🫶

goose(1), goose-acp(1), goose-completion(1), goose-configure(1), goose-doctor(1), goose-gateway(1), goose-info(1), goose-mcp(1), goose-plugin(1), goose-recipe(1), goose-review(1), goose-run(1), goose-schedule(1), goose-session(1), goose-skills(1), goose-term(1)

---

and that's the page! 🎀 this little beauty comes to you straight from the serve source in the General Commands Manual — yes, the footer literally just says serve twice, once as the source and once as the manual, iconic behaviour ngl. slay, go start a server, periodt 💅✨