@doist/outline-cli 0.0.1 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+## [1.0.1](https://github.com/Doist/outline-cli/compare/v1.0.0...v1.0.1) (2026-03-25)
+
+
+### Bug Fixes
+
+* correct skill name and quote YAML description ([#38](https://github.com/Doist/outline-cli/issues/38)) ([e0e4fa4](https://github.com/Doist/outline-cli/commit/e0e4fa435dcfc89b1e29e4b8d02d6ba911dfdb7f))
+
+# 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,176 @@
+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 { DEFAULT_OAUTH_CALLBACK_PORT, startOAuthCallbackServer } from '../lib/oauth-server.js';
+import { buildAuthorizationUrl, exchangeCodeForToken } from '../lib/oauth.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,106 @@
+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;