Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buttons.sh/llms.txt

Use this file to discover all available pages before exploring further.

1

Install

curl -fsSL https://raw.githubusercontent.com/autonoco/buttons/main/install.sh | sh
Or see installation for Docker, Go, and other options.
2

Create a button

Create an HTTP button that fetches weather data:
buttons create weather \
  --url 'https://wttr.in/{{city}}?format=j1' \
  --arg city:string:required \
  -d "Get current weather for a city"
3

Press it

buttons press weather --arg city=Miami
The button calls the API, substitutes city into the URL template, and prints the response.
4

See the result

buttons press weather --arg city=Miami --json

{
  "ok": true,
  "data": {
    "status": "ok",
    "stdout": "{\"current_condition\": [...]}",
    "button": "weather"
  }
}
Every command supports --json for structured output. Piped output auto-detects non-TTY and switches to JSON automatically.
5

View history

buttons history weather
Every press is recorded as a JSON file in the button’s pressed/ folder.

​
What to try next

Code buttons

Run inline shell, Python, or Node scripts.

Prompt buttons

Attach instructions for the consuming agent.

Arguments

Typed args with validation.

CLI reference

Full flag reference for create.