@doist/outline-cli 0.0.1 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# 1.0.0 (2026-03-25)
+
+
+### Bug Fixes
+
+* broaden CI detection to handle all truthy values ([7dc2806](https://github.com/Doist/outline-cli/commit/7dc2806a344d8be841fb9fae80dce59dc6667fac))
+* exclude dist from biome checks ([0dc49a3](https://github.com/Doist/outline-cli/commit/0dc49a38515ae75005f253413b171c6c6b48e99a))
+
+
+### Features
+
+* add API Spinner Proxy ([#17](https://github.com/Doist/outline-cli/issues/17)) ([a3bc75a](https://github.com/Doist/outline-cli/commit/a3bc75afaf81b684703b0e821d5fec0cf05a29cb))
+* add fuzzy reference resolution ([#19](https://github.com/Doist/outline-cli/issues/19)) ([6c1c6f9](https://github.com/Doist/outline-cli/commit/6c1c6f97762809ddf3e4d912892c3582cf9f8b36))
+* add npm publishing, new agent skills, and skill auto-update ([#36](https://github.com/Doist/outline-cli/issues/36)) ([bcb2e75](https://github.com/Doist/outline-cli/commit/bcb2e7593447ca35069316636cbfda02bb86fb91)), closes [Doist/todoist-cli#176](https://github.com/Doist/todoist-cli/issues/176) [Doist/bob-cli#17](https://github.com/Doist/bob-cli/issues/17) [Doist/twist-cli#101](https://github.com/Doist/twist-cli/issues/101)
+* add structured error formatting with codes and hints ([#18](https://github.com/Doist/outline-cli/issues/18)) ([17658d2](https://github.com/Doist/outline-cli/commit/17658d2a66d30939146b1fb5625782df122ff315))
+* implement OAuth PKCE browser login ([#20](https://github.com/Doist/outline-cli/issues/20)) ([b7f6eec](https://github.com/Doist/outline-cli/commit/b7f6eec84250b6d8ceea5e5f1b282bdb550b8092)), closes [#7](https://github.com/Doist/outline-cli/issues/7) [outline/outline#11254](https://github.com/outline/outline/issues/11254)
+* improve oauth login inputs and callback UX ([#31](https://github.com/Doist/outline-cli/issues/31)) ([3011b28](https://github.com/Doist/outline-cli/commit/3011b28a2f3a0b04460ad8def9ed39426b7a1df3))

package/README.md

@@ -1,45 +1,146 @@
-# @doist/outline-cli
+# Outline CLI
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+CLI for the [Outline](https://www.getoutline.com) wiki/knowledge base API.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Installation
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+> ```bash
+> npm install -g @doist/outline-cli
+> ```
 
-## Purpose
+### Agent Skills
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@doist/outline-cli`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+Install skills for your coding agent:
 
-## What is OIDC Trusted Publishing?
+```bash
+ol skill install claude-code
+ol skill install codex
+ol skill install cursor
+ol skill install gemini
+ol skill install pi
+ol skill install universal
+```
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+Skills are installed to `~/<agent-dir>/skills/outline-cli/SKILL.md` (e.g. `~/.claude/` for claude-code, `~/.agents/` for universal, etc.). When updating the CLI, installed skills are updated automatically. The `universal` agent is compatible with Amp, OpenCode, and other agents that read from `~/.agents/`.
 
-## Setup Instructions
+```bash
+ol skill list
+ol skill uninstall <agent>
+```
 
-To properly configure OIDC trusted publishing for this package:
+## Uninstallation
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+First, remove any installed agent skills:
 
-## DO NOT USE THIS PACKAGE
+```bash
+ol skill uninstall <agent>
+```
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+Then uninstall the CLI:
 
-## More Information
+```bash
+npm uninstall -g @doist/outline-cli
+```
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+## Local Setup
 
----
+```bash
+git clone https://github.com/Doist/outline-cli.git
+cd outline-cli
+npm install
+npm run build
+npm link
+```
 
-**Maintained for OIDC setup purposes only**
+## Setup
+
+### OAuth login (recommended)
+
+```bash
+ol auth login
+ol auth login --base-url <your-outline-url>
+ol auth login --client-id <your-client-id>
+ol auth login --callback-port 54969
+ol auth status
+ol auth logout
+```
+
+**Setup:**
+
+1. Create a public OAuth app in Outline (Settings → Applications)
+2. Set the redirect URI to `http://localhost:54969/callback`
+3. Run `ol auth login` and enter your OAuth client ID when prompted
+   (or pass it directly with `--client-id <your-client-id>`)
+4. If needed, pass `--base-url <your-outline-url>` or set `OUTLINE_URL`
+   (for self-hosted instances or non-default URLs)
+5. If needed, pass `--callback-port <port>` or set `OUTLINE_OAUTH_CALLBACK_PORT`
+   and register `http://localhost:<port>/callback` in your OAuth app
+
+The client ID is saved for future logins. You can also set `OUTLINE_OAUTH_CLIENT_ID`
+for your local environment.
+
+### Manual token login
+
+If you prefer using an API token directly:
+
+```bash
+ol auth login --token <your-api-token>
+```
+
+Generate a token in Outline under Settings → API Tokens.
+
+### Configuration
+
+Token resolution: `OUTLINE_API_TOKEN` env var → `~/.config/outline-cli/config.json`.
+
+Base URL resolution: `OUTLINE_URL` env var → config file → `https://app.getoutline.com`.
+
+Callback port resolution for OAuth login:
+`--callback-port` → `OUTLINE_OAUTH_CALLBACK_PORT` → `54969`.
+
+Self-hosted instances: pass `--base-url` or set `OUTLINE_URL` (you can still provide it interactively).
+
+## Commands
+
+```bash
+# Search
+ol search "query" --limit 10 --collection <id> --status published
+
+# Documents (alias: ol doc)
+ol document list --collection <id> --sort updatedAt --direction DESC
+ol document get <urlId>              # renders markdown for terminal
+ol document get <urlId> --raw        # outputs raw markdown
+ol document open <urlId>             # opens in browser
+ol document create --title "Title" --collection <id> --file doc.md --publish
+ol document update <urlId> --file updated.md
+ol document delete <urlId> --confirm
+ol document move <urlId> --collection <target-id>
+ol document archive <urlId>
+ol document unarchive <urlId>
+
+# Collections (alias: ol col)
+ol collection list
+ol collection get <id>
+ol collection create --name "Engineering" --color "#4CAF50"
+ol collection update <id> --name "New Name"
+ol collection delete <id> --confirm
+```
+
+## Output modes
+
+All commands support:
+
+- Default: colored human-readable output
+- `--json`: pretty-printed JSON (essential fields)
+- `--json --full`: all fields
+- `--ndjson`: one JSON object per line (for piping)
+
+## Development
+
+```bash
+npm install
+npm run dev          # watch mode
+npm run type-check   # typecheck without emitting
+npm run test         # run tests
+npm run build        # compile to dist/
+```

package/dist/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerAuthCommand(program: Command): void;

package/dist/commands/auth.js

@@ -0,0 +1,179 @@
+import { createInterface } from "node:readline/promises";
+import chalk from "chalk";
+import open from "open";
+import { apiRequest } from "../lib/api.js";
+import { clearConfig, getBaseUrl, getOAuthClientId, getTokenSource, saveConfig, } from "../lib/auth.js";
+import { buildAuthorizationUrl, exchangeCodeForToken } from "../lib/oauth.js";
+import { DEFAULT_OAUTH_CALLBACK_PORT, startOAuthCallbackServer, } from "../lib/oauth-server.js";
+import { formatError } from "../lib/output.js";
+import { generateCodeChallenge, generateCodeVerifier, generateState, } from "../lib/pkce.js";
+async function prompt(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return await rl.question(question);
+    }
+    finally {
+        rl.close();
+    }
+}
+function parseCallbackPort(rawPort) {
+    const parsed = Number(rawPort);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65_535) {
+        return null;
+    }
+    return parsed;
+}
+export function registerAuthCommand(program) {
+    const auth = program.command("auth").description("Manage authentication");
+    auth
+        .command("login")
+        .description("Authenticate with an Outline instance")
+        .option("--token <token>", "Authenticate using a personal API token")
+        .option("--base-url <url>", "Outline base URL to use for this login (saved for future logins)")
+        .option("--client-id <clientId>", "OAuth client ID to use for this login (saved for future logins)")
+        .option("--callback-port <port>", `Local OAuth callback port (default: ${DEFAULT_OAUTH_CALLBACK_PORT})`)
+        .action(async (options) => {
+        const configuredBaseUrl = getBaseUrl();
+        const optionBaseUrl = options.baseUrl?.trim();
+        const envBaseUrl = process.env.OUTLINE_URL?.trim();
+        let url = optionBaseUrl || envBaseUrl;
+        if (!url) {
+            const baseUrlInput = await prompt(`Base URL (default: ${configuredBaseUrl}): `);
+            url = baseUrlInput.trim() || configuredBaseUrl;
+        }
+        url = url.replace(/\/$/, "");
+        const optionClientId = options.clientId?.trim();
+        const optionCallbackPort = options.callbackPort?.trim();
+        const envCallbackPort = process.env.OUTLINE_OAUTH_CALLBACK_PORT?.trim();
+        const rawCallbackPort = optionCallbackPort || envCallbackPort;
+        let callbackPort = DEFAULT_OAUTH_CALLBACK_PORT;
+        if (rawCallbackPort) {
+            const parsedPort = parseCallbackPort(rawCallbackPort);
+            if (!parsedPort) {
+                console.error(formatError("OAUTH_CALLBACK_PORT_INVALID", `Invalid callback port: ${rawCallbackPort}`, [
+                    "Use an integer between 1 and 65535",
+                    "Set via --callback-port or OUTLINE_OAUTH_CALLBACK_PORT",
+                ]));
+                process.exit(1);
+            }
+            callbackPort = parsedPort;
+        }
+        if (options.token) {
+            saveConfig(options.token.trim(), url, optionClientId);
+            try {
+                const { data } = await apiRequest("auth.info");
+                console.log(chalk.green(`Authenticated to ${data.team.name} as ${data.user.name}`));
+            }
+            catch (err) {
+                console.log(chalk.yellow("Token saved, but could not verify:"), err.message);
+            }
+            return;
+        }
+        const existingClientId = getOAuthClientId();
+        let clientId = optionClientId || existingClientId;
+        if (!clientId) {
+            const clientIdInput = await prompt("OAuth Client ID: ");
+            clientId = clientIdInput.trim();
+        }
+        if (!clientId) {
+            console.error(formatError("OAUTH_CLIENT_ID_REQUIRED", "OAuth client ID is required.", [
+                "Create a public OAuth app in Outline settings",
+                "Use --client-id <id> for this login",
+                "Set OUTLINE_OAUTH_CLIENT_ID or enter it here",
+            ]));
+            process.exit(1);
+        }
+        const codeVerifier = generateCodeVerifier();
+        const codeChallenge = generateCodeChallenge(codeVerifier);
+        const state = generateState();
+        let callbackServer;
+        try {
+            callbackServer = await startOAuthCallbackServer({
+                state,
+                port: callbackPort,
+            });
+        }
+        catch (err) {
+            const error = err;
+            const hints = [
+                `Ensure http://localhost:${callbackPort}/callback is reachable from your browser`,
+                "Re-run with 'ol auth login --token <token>' for manual auth",
+            ];
+            if (error.code === "EADDRINUSE") {
+                hints.unshift(`Port ${callbackPort} is already in use. Close the other process using it.`);
+            }
+            console.error(formatError("OAUTH_CALLBACK_SERVER_FAILED", `Could not start local OAuth callback server: ${error.message}`, hints));
+            process.exit(1);
+        }
+        const authorizationUrl = buildAuthorizationUrl({
+            baseUrl: url,
+            clientId,
+            redirectUri: callbackServer.redirectUri,
+            codeChallenge,
+            state,
+        });
+        try {
+            await open(authorizationUrl);
+        }
+        catch (err) {
+            console.log(chalk.yellow("Could not open browser automatically."), chalk.dim(authorizationUrl));
+            console.log(chalk.dim(err.message));
+        }
+        console.log(chalk.dim("Waiting for OAuth authorization..."));
+        try {
+            const code = await callbackServer.waitForCode;
+            const token = await exchangeCodeForToken({
+                baseUrl: url,
+                clientId,
+                redirectUri: callbackServer.redirectUri,
+                codeVerifier,
+                code,
+            });
+            saveConfig(token, url, clientId);
+            const { data } = await apiRequest("auth.info");
+            console.log(chalk.green(`Authenticated to ${data.team.name} as ${data.user.name}`));
+        }
+        catch (err) {
+            callbackServer.close();
+            console.error(formatError("OAUTH_LOGIN_FAILED", `OAuth login failed: ${err.message}`, [
+                "Confirm the OAuth app redirect URI matches the CLI callback",
+                "Verify --base-url or OUTLINE_URL points to your Outline instance",
+                "Re-run with 'ol auth login --token' for manual auth",
+            ]));
+            process.exit(1);
+        }
+    });
+    auth
+        .command("status")
+        .description("Show current authentication state")
+        .action(async () => {
+        const source = getTokenSource();
+        if (!source) {
+            console.log(chalk.yellow("Not authenticated. Run: ol auth login"));
+            return;
+        }
+        console.log(chalk.dim(`Token source: ${source}`));
+        console.log(chalk.dim(`Base URL: ${getBaseUrl()}`));
+        try {
+            const { data } = await apiRequest("auth.info");
+            console.log(`Team: ${chalk.bold(data.team.name)}`);
+            console.log(`User: ${data.user.name} (${data.user.email})`);
+        }
+        catch (err) {
+            console.error(formatError("AUTH_VERIFICATION_FAILED", `Could not fetch auth info: ${err.message}`, [
+                "Check that your API token is valid",
+                "Verify the base URL is correct",
+                "Run 'ol auth login' to re-authenticate",
+            ]));
+            process.exit(1);
+        }
+    });
+    auth
+        .command("logout")
+        .description("Clear saved authentication")
+        .action(() => {
+        clearConfig();
+        console.log("Logged out.");
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/commands/collection.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerCollectionCommand(program: Command): void;

package/dist/commands/collection.js

@@ -0,0 +1,120 @@
+import chalk from "chalk";
+import { apiRequest } from "../lib/api.js";
+import { formatError, getOutputOptions, outputItem, outputList, } from "../lib/output.js";
+import { resolveCollectionId, resolveCollectionRef } from "../lib/refs.js";
+const essentialKeys = [
+    "id",
+    "name",
+    "description",
+    "color",
+    "documentCount",
+];
+function formatCollection(col) {
+    const name = chalk.bold(col.name);
+    const id = chalk.dim(col.id);
+    const count = chalk.dim(`${col.documentCount} docs`);
+    return `${name} ${id} ${count}`;
+}
+export function registerCollectionCommand(program) {
+    const col = program
+        .command("collection")
+        .alias("col")
+        .description("Manage collections");
+    col
+        .command("list")
+        .description("List collections")
+        .option("--limit <n>", "Max results", "25")
+        .option("--offset <n>", "Pagination offset", "0")
+        .option("--json", "Output JSON")
+        .option("--ndjson", "Output NDJSON")
+        .option("--full", "Include all fields in JSON output")
+        .action(async (opts) => {
+        const { data, pagination } = await apiRequest("collections.list", {
+            limit: Number(opts.limit),
+            offset: Number(opts.offset),
+        });
+        outputList(data, formatCollection, essentialKeys, getOutputOptions(opts), pagination);
+    });
+    col
+        .command("get <id>")
+        .description("Get collection details by ID or name")
+        .option("--json", "Output JSON")
+        .option("--full", "Include all fields in JSON output")
+        .action(async (id, opts) => {
+        const resolved = await resolveCollectionRef(id);
+        // If resolved from name search (collections.list), some fields may be missing
+        let data;
+        if (resolved.documentCount !== undefined) {
+            data = resolved;
+        }
+        else {
+            const response = await apiRequest("collections.info", {
+                id: resolved.id,
+            });
+            data = response.data;
+        }
+        outputItem(data, formatCollection, essentialKeys, getOutputOptions(opts));
+    });
+    col
+        .command("create")
+        .description("Create a collection")
+        .requiredOption("--name <name>", "Collection name")
+        .option("--description <text>", "Description")
+        .option("--color <hex>", "Color hex code")
+        .option("--private", "Make private")
+        .option("--json", "Output JSON")
+        .action(async (opts) => {
+        const body = { name: opts.name };
+        if (opts.description)
+            body.description = opts.description;
+        if (opts.color)
+            body.color = opts.color;
+        if (opts.private)
+            body.permission = "";
+        const { data } = await apiRequest("collections.create", body);
+        if (opts.json) {
+            outputItem(data, formatCollection, essentialKeys, { json: true });
+        }
+        else {
+            console.log(chalk.green(`Created: ${data.name}`), chalk.dim(data.id));
+        }
+    });
+    col
+        .command("update <id>")
+        .description("Update a collection")
+        .option("--name <name>", "New name")
+        .option("--description <text>", "New description")
+        .option("--color <hex>", "New color")
+        .option("--json", "Output JSON")
+        .action(async (id, opts) => {
+        const resolvedId = await resolveCollectionId(id);
+        const body = { id: resolvedId };
+        if (opts.name)
+            body.name = opts.name;
+        if (opts.description)
+            body.description = opts.description;
+        if (opts.color)
+            body.color = opts.color;
+        const { data } = await apiRequest("collections.update", body);
+        if (opts.json) {
+            outputItem(data, formatCollection, essentialKeys, { json: true });
+        }
+        else {
+            console.log(chalk.green(`Updated: ${data.name}`), chalk.dim(data.id));
+        }
+    });
+    col
+        .command("delete <id>")
+        .description("Delete a collection")
+        .option("--confirm", "Skip confirmation")
+        .action(async (id, opts) => {
+        if (!opts.confirm) {
+            console.error(formatError("CONFIRMATION_REQUIRED", "Delete operation requires confirmation.", ["Use --confirm flag to proceed with deletion"]));
+            process.exit(1);
+        }
+        const resolvedId = await resolveCollectionId(id);
+        await apiRequest("collections.delete", { id: resolvedId });
+        console.log("Deleted.");
+    });
+}
+//# sourceMappingURL=collection.js.map

package/dist/commands/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/commands/collection.ts"],"names":[],"mappings":"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"}

package/dist/commands/document.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerDocumentCommand(program: Command): void;