# Goose.quickstart

> Agent workflow for running Goose in headless mode with non-interactive defaults and structured output.

- Skill: `javimosch/goose-quickstart` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/goose-quickstart`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/goose-quickstart/raw
- Safety review: PASS (external: skill-scanner WARNING, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/goose-quickstart

---


# Goose Quickstart

Use this when you need Goose in scripts, CI, or agent workflows without interactive prompts.

## 1) Install plugin and dependency

```bash
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
supercli plugins install goose --json
```

## 2) Validate setup

```bash
supercli goose cli version
```

## 3) Headless wrappers

```bash
supercli goose task text --text "Summarize this repository"
supercli goose task json --text "Return the top risks in JSON"
supercli goose task stream --text "Plan a refactor"
supercli goose task file --instructions ./task.txt
```

## 4) Passthrough for advanced flags

```bash
supercli goose run --text "Explain the architecture" --output-format json --no-session
supercli goose run --instructions ./task.txt --output-format stream-json --no-session
```

## 5) Caveats

- Wrapped commands include `--no-session` and `--quiet` by default.
- `task stream` returns JSONL event lines; consume them line by line.
- Use passthrough for recipes, provider configuration, or flags not covered by wrappers.