outline-cli

The best wiki CLI: push, pull, search, and read Outline wiki documents from your terminal.

Why outline-cli?

Stay in your terminal — no context switching to a browser
Docs-as-code — version control your wiki content in git
CI/CD native — publish docs automatically on every merge
Secure by default — credentials stored in OS keyring (OWASP-aligned)

Quick Start

# Install
curl -sL "https://github.com/Breee/outline-cli/releases/latest/download/outline_linux_amd64.tar.gz" | sudo tar xz -C /usr/local/bin outline

# Authenticate
export OUTLINE_SERVER_URL=https://outline.example.com
export OUTLINE_API_TOKEN=sk-your-token

# Push docs
outline push --collection-id "Engineering" --path ./docs/

Features

Feature	Description
Push	Push markdown files or directory trees to Outline
Upsert	Updates existing docs by title, creates if not found
Metadata	Per-file collection, title, icon, parent via HTML comments
Images	Auto-upload local images as attachments
OIDC	Browser login with PKCE + Dynamic Client Registration
Keyring	All credentials in OS keyring (API token, password, OIDC)
Config	YAML config with `config set/get/list` commands
CI/CD	Works with env vars only — no config file needed

AI Integration

This documentation is optimized for AI consumption:

llms.txt — structured index for LLM discovery
llms-full.txt — complete documentation as single file
Every page has llmsDescription frontmatter for precise AI context

Next Steps

Read the Docs

Installation, usage, configuration, and full CLI reference