CLI Reference

The AgentPreso CLI is a standalone binary that works with local files and cloud storage. No Node.js required.

Global Options

These options apply to all commands:

Option	Description
`--help`, `-h`	Show help for a command
`--version`, `-v`	Show CLI version
`--config <path>`	Use a custom config file
`--quiet`, `-q`	Suppress non-error output
`--verbose`	Show detailed output

Authentication Commands

`agentpreso login`

Authenticate with the AgentPreso server and store your API key locally.

agentpreso login

Opens a browser window for authentication. After successful login, your API key is stored in ~/.agentpreso/credentials.

Options:

Option	Description
`--server <url>`	Use a custom server URL
`--key <api-key>`	Provide an API key directly (non-interactive)

`agentpreso logout`

Remove stored credentials.

agentpreso logout

`agentpreso whoami`

Display the currently authenticated user and server.

agentpreso whoami

Output:

Logged in as: [email protected]
Server: https://api.agentpreso.com

Deck Commands

`agentpreso create <name>`

Create a new presentation from a template.

agentpreso create quarterly-review

Options:

Option	Description
`--template`, `-t`	Template to use (default: `minimal`)
`--output`, `-o`	Output directory (default: current directory)

Examples:

# Create with corporate template
agentpreso create sales-deck --template corporate

# Create in a specific directory
agentpreso create pitch --output ./presentations

`agentpreso render <file>`

Render a presentation to HTML, PDF, or PowerPoint.

agentpreso render presentation.md

Options:

Option	Description
`--format`, `-f`	Output format: `html`, `pdf`, `pptx` (default: `html`)
`--output`, `-o`	Output file path
`--template`, `-t`	Override template from frontmatter
`--watch`, `-w`	Watch for changes and re-render

Examples:

# Render to PDF
agentpreso render deck.md --format pdf

# Custom output path
agentpreso render deck.md --format pptx --output ./output/final.pptx

# Watch mode
agentpreso render deck.md --watch

`agentpreso serve <file>`

Start a local development server with hot-reload preview.

agentpreso serve presentation.md

Options:

Option	Description
`--port`, `-p`	Server port (default: `3000`)
`--host`	Host to bind to (default: `localhost`)
`--open`	Open browser automatically

Examples:

# Custom port
agentpreso serve deck.md --port 8080

# Open browser automatically
agentpreso serve deck.md --open

`agentpreso push [file]`

Upload a local deck to cloud storage.

agentpreso push presentation.md

If no file is specified, pushes all .md files in the current directory that have AgentPreso frontmatter.

Options:

Option	Description
`--slug`	Override the deck slug (default: filename)
`--force`	Overwrite existing deck without confirmation

Examples:

# Push with custom slug
agentpreso push deck.md --slug q3-results

# Force overwrite
agentpreso push deck.md --force

`agentpreso pull <slug>`

Download a cloud deck to a local file.

agentpreso pull quarterly-review

Options:

Option	Description
`--output`, `-o`	Output file path (default: `<slug>.md`)
`--force`	Overwrite existing local file

Examples:

# Custom output path
agentpreso pull q3-results --output ./decks/q3.md

`agentpreso list`

List your cloud decks.

agentpreso list

Options:

Option	Description
`--json`	Output as JSON
`--limit`, `-n`	Maximum number of results

Output:

SLUG              TITLE                    UPDATED
quarterly-review  Q3 2024 Review           2 hours ago
sales-pitch       Enterprise Sales Deck    3 days ago
onboarding        New Hire Onboarding      1 week ago

Template Commands

`agentpreso templates`

List available templates.

agentpreso templates

Options:

Option	Description
`--json`	Output as JSON

Output:

NAME        DESCRIPTION                              TYPE
minimal     Clean, lots of whitespace                built-in
dark        Dark background, high contrast           built-in
corporate   Professional, muted blues/grays          built-in
creative    Bold colors, modern typography           built-in
my-brand    Custom company branding                  custom

`agentpreso templates add <path>`

Upload a custom template to your account.

agentpreso templates add ./my-template/

The path should be a directory containing:

template.yaml - manifest file
theme.css - Marp theme CSS
scaffold.md - optional starter content
assets/ - optional directory with images

Configuration Commands

`agentpreso config`

Show current configuration.

agentpreso config

`agentpreso config set <key> <value>`

Set a configuration value.

agentpreso config set defaults.template corporate

Available settings:

Key	Description
`server.url`	API server URL
`defaults.template`	Default template for new decks
`defaults.format`	Default render format

`agentpreso config reset`

Reset configuration to defaults.

agentpreso config reset

Configuration Files

`~/.agentpreso/config.yaml`

Global configuration:

server:
  url: https://api.agentpreso.com
defaults:
  template: minimal
  format: html

`~/.agentpreso/credentials`

API key storage (do not commit to version control):

api_key: imp_a1b2c3d4e5f6...

Exit Codes

Code	Description
`0`	Success
`1`	General error
`2`	Invalid arguments
`3`	Authentication required
`4`	Network error
`5`	File not found