@todoist/outline-cli 0.0.1 → 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,359 @@
+## [3.0.0](https://github.com/todoist/outline-cli/compare/v2.5.4...v3.0.0) (2026-11-11)
+
+### ⚠ BREAKING CHANGES
+
+* publish as @todoist/outline-cli (#174)
+
+### Features
+
+* publish as @todoist/outline-cli ([#174](https://github.com/todoist/outline-cli/issues/174)) ([d1ddf8b](https://github.com/todoist/outline-cli/commit/d1ddf8b7d331bbbf4e9e13a3f20763de560ff512))
+
+## [2.5.4](https://github.com/todoist/outline-cli/compare/v2.5.3...v2.5.4) (2026-11-11)
+
+### Bug Fixes
+
+* **ci:** use the todoist GitHub org after the rename ([#173](https://github.com/todoist/outline-cli/issues/173)) ([b9938ef](https://github.com/todoist/outline-cli/commit/b9938efe45f9188a9c1bfaf45e27b87ca34bb9c9))
+
+## [2.5.3](https://github.com/Doist/outline-cli/compare/v2.5.2...v2.5.3) (2026-11-11)
+
+### Bug Fixes
+
+* **deps:** update dependency @doist/cli-core to v1.10.0 ([#172](https://github.com/Doist/outline-cli/issues/172)) ([6acaa6a](https://github.com/Doist/outline-cli/commit/6acaa6a6e15dcbb3e7506a15c772b17fb621b6d0))
+
+## [2.5.2](https://github.com/Doist/outline-cli/compare/v2.5.1...v2.5.2) (2026-11-10)
+
+### Bug Fixes
+
+* **deps:** update dependency undici to v7.30.2 ([#171](https://github.com/Doist/outline-cli/issues/171)) ([c8d92d7](https://github.com/Doist/outline-cli/commit/c8d92d7e80b7469eeb42e271a3a16217cfce359d))
+
+## [2.5.1](https://github.com/Doist/outline-cli/compare/v2.5.0...v2.5.1) (2026-11-09)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.1.3 ([#168](https://github.com/Doist/outline-cli/issues/168)) ([b1a1d23](https://github.com/Doist/outline-cli/commit/b1a1d237059d31f5ea6646d7e1598f43211d5683))
+
+## [2.5.0](https://github.com/Doist/outline-cli/compare/v2.4.0...v2.5.0) (2026-11-07)
+
+### Features
+
+* read markdown from stdin with `--stdin` ([#166](https://github.com/Doist/outline-cli/issues/166)) ([c82d17e](https://github.com/Doist/outline-cli/commit/c82d17e2963ea9ebb49520c68f4de0052ea30712))
+
+## [2.4.0](https://github.com/Doist/outline-cli/compare/v2.3.2...v2.4.0) (2026-11-07)
+
+### Features
+
+* add `doc restore` to restore documents from the trash ([#165](https://github.com/Doist/outline-cli/issues/165)) ([b1e86eb](https://github.com/Doist/outline-cli/commit/b1e86eb21ef299e6b2c524eddeadc55b0b092c02))
+
+## [2.3.2](https://github.com/Doist/outline-cli/compare/v2.3.1...v2.3.2) (2026-11-02)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.1.2 ([#162](https://github.com/Doist/outline-cli/issues/162)) ([a73eae3](https://github.com/Doist/outline-cli/commit/a73eae3c05e039be19c2e0dbc803f45f7c9520c9))
+
+## [2.3.1](https://github.com/Doist/outline-cli/compare/v2.3.0...v2.3.1) (2026-10-24)
+
+### Bug Fixes
+
+* **deps:** update dependency @doist/cli-core to v1.7.2 ([#159](https://github.com/Doist/outline-cli/issues/159)) ([3e54b58](https://github.com/Doist/outline-cli/commit/3e54b58c482972dff1f00d9dc408cdd9092773ff)), closes [Doist/cli-core#155](https://github.com/Doist/cli-core/issues/155) [Doist/todoist-cli#577](https://github.com/Doist/todoist-cli/issues/577)
+
+## [2.3.0](https://github.com/Doist/outline-cli/compare/v2.2.0...v2.3.0) (2026-10-23)
+
+### Features
+
+* add `doc update --if-updated-at` to refuse overwriting newer changes ([#157](https://github.com/Doist/outline-cli/issues/157)) ([7fd2e15](https://github.com/Doist/outline-cli/commit/7fd2e15c89ac5af7a779d6517778867d863bc3a2))
+
+## [2.2.0](https://github.com/Doist/outline-cli/compare/v2.1.12...v2.2.0) (2026-10-23)
+
+### Features
+
+* add `doc update --publish` to publish drafts ([#156](https://github.com/Doist/outline-cli/issues/156)) ([e155c92](https://github.com/Doist/outline-cli/commit/e155c92f7c02ace1e8693e546debd7a9077d39b5))
+
+## [2.1.12](https://github.com/Doist/outline-cli/compare/v2.1.11...v2.1.12) (2026-10-23)
+
+### Bug Fixes
+
+* resolve document refs from browser URLs with anchors, queries or trailing paths ([#155](https://github.com/Doist/outline-cli/issues/155)) ([78b0087](https://github.com/Doist/outline-cli/commit/78b008750500ddf54adb6172fc151e0fdef2e647))
+
+## [2.1.11](https://github.com/Doist/outline-cli/compare/v2.1.10...v2.1.11) (2026-10-21)
+
+### Bug Fixes
+
+* **deps:** update dependency undici to v7.30.1 ([#154](https://github.com/Doist/outline-cli/issues/154)) ([2dc878d](https://github.com/Doist/outline-cli/commit/2dc878dedea498c862819aede563c51372648887))
+
+## [2.1.10](https://github.com/Doist/outline-cli/compare/v2.1.9...v2.1.10) (2026-10-20)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.1.1 ([#151](https://github.com/Doist/outline-cli/issues/151)) ([d4c9013](https://github.com/Doist/outline-cli/commit/d4c9013296e7bd7b6d7d9cbcd93b147590122b4b))
+
+## [2.1.9](https://github.com/Doist/outline-cli/compare/v2.1.8...v2.1.9) (2026-10-14)
+
+### Bug Fixes
+
+* **search:** accept --offset, which the more-results hint suggests ([#148](https://github.com/Doist/outline-cli/issues/148)) ([0b3dc79](https://github.com/Doist/outline-cli/commit/0b3dc79222fe52c19f3329f8bedd2c747b32e104))
+
+## [2.1.8](https://github.com/Doist/outline-cli/compare/v2.1.7...v2.1.8) (2026-10-12)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.1.0 ([#145](https://github.com/Doist/outline-cli/issues/145)) ([c5043ac](https://github.com/Doist/outline-cli/commit/c5043aca1bf05e541c71e9dd87c91e0c637280e9))
+
+## [2.1.7](https://github.com/Doist/outline-cli/compare/v2.1.6...v2.1.7) (2026-10-02)
+
+### Bug Fixes
+
+* **deps:** update dependency chalk to v6.0.1 ([#137](https://github.com/Doist/outline-cli/issues/137)) ([66cdac7](https://github.com/Doist/outline-cli/commit/66cdac7a29ec08217ab8c80165b2764bc1289bd2))
+
+## [2.1.6](https://github.com/Doist/outline-cli/compare/v2.1.5...v2.1.6) (2026-10-01)
+
+### Bug Fixes
+
+* **deps:** update dependency undici to v7.30.0 ([#136](https://github.com/Doist/outline-cli/issues/136)) ([23acd1d](https://github.com/Doist/outline-cli/commit/23acd1d94f6ba5a792550b10b2ef8f6cb87a3f43))
+
+## [2.1.5](https://github.com/Doist/outline-cli/compare/v2.1.4...v2.1.5) (2026-09-30)
+
+### Bug Fixes
+
+* **deps:** update dependency @doist/cli-core to v1.7.0 ([#134](https://github.com/Doist/outline-cli/issues/134)) ([0bad4c9](https://github.com/Doist/outline-cli/commit/0bad4c9bda026ea68f3d0d6913bd7d6c0cea3f34))
+
+## [2.1.4](https://github.com/Doist/outline-cli/compare/v2.1.3...v2.1.4) (2026-09-29)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.0.14 ([#132](https://github.com/Doist/outline-cli/issues/132)) ([bac5f8e](https://github.com/Doist/outline-cli/commit/bac5f8e24b39dda6283722bce7a1442f7c96a5cd))
+
+## [2.1.3](https://github.com/Doist/outline-cli/compare/v2.1.2...v2.1.3) (2026-09-22)
+
+### Bug Fixes
+
+* **deps:** update dependency open to v11.0.4 ([#129](https://github.com/Doist/outline-cli/issues/129)) ([0c97777](https://github.com/Doist/outline-cli/commit/0c977770ccc58c3f2814efc994427d2ef7ede9c5))
+
+## [2.1.2](https://github.com/Doist/outline-cli/compare/v2.1.1...v2.1.2) (2026-09-18)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.0.13 ([#125](https://github.com/Doist/outline-cli/issues/125)) ([6e092d9](https://github.com/Doist/outline-cli/commit/6e092d9fac39778deca4def3614669b2c97cf36f))
+
+## [2.1.1](https://github.com/Doist/outline-cli/compare/v2.1.0...v2.1.1) (2026-09-17)
+
+### Bug Fixes
+
+* **deps:** update dependency open to v11.0.3 ([#124](https://github.com/Doist/outline-cli/issues/124)) ([53b8d97](https://github.com/Doist/outline-cli/commit/53b8d97bf8f70dded0c1d7f44242c168ced1c10f))
+
+## [2.1.0](https://github.com/Doist/outline-cli/compare/v2.0.9...v2.1.0) (2026-09-16)
+
+### Features
+
+* **auth:** refresh an expiring OAuth token before `token view` / `status` ([#123](https://github.com/Doist/outline-cli/issues/123)) ([2584eaf](https://github.com/Doist/outline-cli/commit/2584eaf33f0368285ee47e4d3d94adcd6696d66f))
+
+## [2.0.9](https://github.com/Doist/outline-cli/compare/v2.0.8...v2.0.9) (2026-09-15)
+
+### Bug Fixes
+
+* **deps:** update dependency @doist/cli-core to v1.5.0 ([#121](https://github.com/Doist/outline-cli/issues/121)) ([ebf2ac8](https://github.com/Doist/outline-cli/commit/ebf2ac82c1b64b3f5da3554b4bb62d26e3e79e3f))
+
+## [2.0.8](https://github.com/Doist/outline-cli/compare/v2.0.7...v2.0.8) (2026-09-14)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.0.12 ([#119](https://github.com/Doist/outline-cli/issues/119)) ([fa615c5](https://github.com/Doist/outline-cli/commit/fa615c5bf4cfcb99a3f320e79e9880ee4330ed08))
+
+## [2.0.7](https://github.com/Doist/outline-cli/compare/v2.0.6...v2.0.7) (2026-09-11)
+
+### Bug Fixes
+
+* **deps:** update dependency oauth4webapi to v3.8.8 ([#118](https://github.com/Doist/outline-cli/issues/118)) ([bdbdb0b](https://github.com/Doist/outline-cli/commit/bdbdb0baf954b2ee2157a8e655c617a9d010f086))
+
+## [2.0.6](https://github.com/Doist/outline-cli/compare/v2.0.5...v2.0.6) (2026-09-10)
+
+### Bug Fixes
+
+* **deps:** update dependency undici to v7.29.1 ([#117](https://github.com/Doist/outline-cli/issues/117)) ([f961e02](https://github.com/Doist/outline-cli/commit/f961e0217ab3bc371f5a9589581f9eab23c01a68))
+
+## [2.0.5](https://github.com/Doist/outline-cli/compare/v2.0.4...v2.0.5) (2026-09-04)
+
+### Bug Fixes
+
+* **deps:** update dependency open to v11.0.2 ([#114](https://github.com/Doist/outline-cli/issues/114)) ([7af2e84](https://github.com/Doist/outline-cli/commit/7af2e842aee6dc3f91b2d537737045687fbe912a))
+
+## [2.0.4](https://github.com/Doist/outline-cli/compare/v2.0.3...v2.0.4) (2026-08-29)
+
+### Bug Fixes
+
+* **deps:** update dependency marked to v18.0.11 ([#111](https://github.com/Doist/outline-cli/issues/111)) ([535077a](https://github.com/Doist/outline-cli/commit/535077affb092a85c38bb807283cfe19b7d3db6b))
+
+## [2.0.3](https://github.com/Doist/outline-cli/compare/v2.0.2...v2.0.3) (2026-08-28)
+
+### Bug Fixes
+
+* **deps:** update dependency chalk to v6 ([#107](https://github.com/Doist/outline-cli/issues/107)) ([0cff6e4](https://github.com/Doist/outline-cli/commit/0cff6e4b7e7718047fe7178172a6fd6218c67927))
+
+## [2.0.2](https://github.com/Doist/outline-cli/compare/v2.0.1...v2.0.2) (2026-08-28)
+
+### Bug Fixes
+
+* **deps:** update dependency commander to v15 ([#108](https://github.com/Doist/outline-cli/issues/108)) ([3f82933](https://github.com/Doist/outline-cli/commit/3f82933964955c588caf54515d4a1f75d99ffa2e))
+* **deps:** update dependency open to v11 ([#109](https://github.com/Doist/outline-cli/issues/109)) ([23d2525](https://github.com/Doist/outline-cli/commit/23d2525f3c91f547369b2d07cc79a5240ac07274))
+
+## [2.0.1](https://github.com/Doist/outline-cli/compare/v2.0.0...v2.0.1) (2026-08-28)
+
+### Bug Fixes
+
+* **deps:** pin dependency undici to 7.29.0 ([#94](https://github.com/Doist/outline-cli/issues/94)) ([1049dec](https://github.com/Doist/outline-cli/commit/1049dec715dd77ecb6621cebe068b3a06a5d2d89))
+* **deps:** update dependency marked to v18.0.10 ([#100](https://github.com/Doist/outline-cli/issues/100)) ([b57defd](https://github.com/Doist/outline-cli/commit/b57defd917f1e63a765baf13b04832cfe87899fd))
+* **deps:** update dependency oauth4webapi to v3.8.7 ([#101](https://github.com/Doist/outline-cli/issues/101)) ([5e456b7](https://github.com/Doist/outline-cli/commit/5e456b7cd2a0966c72b28e533b6ab564d38ca6b6))
+
+## [2.0.0](https://github.com/Doist/outline-cli/compare/v1.10.5...v2.0.0) (2026-08-27)
+
+### ⚠ BREAKING CHANGES
+
+* update @doist/cli-core to 1.4.0 and require Node 24 (#93)
+
+### Features
+
+* update @doist/cli-core to 1.4.0 and require Node 24 ([#93](https://github.com/Doist/outline-cli/issues/93)) ([e695029](https://github.com/Doist/outline-cli/commit/e6950291d895133887505c67c984601825320407))
+
+## [1.10.5](https://github.com/Doist/outline-cli/compare/v1.10.4...v1.10.5) (2026-08-27)
+
+### Bug Fixes
+
+* pair the undici dispatcher with its own fetch and bump to 7.29.0 ([#92](https://github.com/Doist/outline-cli/issues/92)) ([173d857](https://github.com/Doist/outline-cli/commit/173d857df858615b81e7d903630fdd379eb93db6))
+
+## [1.10.4](https://github.com/Doist/outline-cli/compare/v1.10.3...v1.10.4) (2026-07-29)
+
+### Bug Fixes
+
+* set Comms audience to thread ([#90](https://github.com/Doist/outline-cli/issues/90)) ([c54be07](https://github.com/Doist/outline-cli/commit/c54be07e95c7c63f29a84d0e51b16673a0e5f519))
+
+## [1.10.3](https://github.com/Doist/outline-cli/compare/v1.10.2...v1.10.3) (2026-07-01)
+
+### Bug Fixes
+
+* **docs:** Update readme with correct token command ([#88](https://github.com/Doist/outline-cli/issues/88)) ([8bfe8a0](https://github.com/Doist/outline-cli/commit/8bfe8a0d4f5a7b8e1be8a5bef1de3c6661cfd205))
+
+## [1.10.2](https://github.com/Doist/outline-cli/compare/v1.10.1...v1.10.2) (2026-06-09)
+
+### Bug Fixes
+
+* build a working dispatcher on runtimes without undici's decompress interceptor (e.g. Bun) ([#84](https://github.com/Doist/outline-cli/issues/84)) ([c2c69d2](https://github.com/Doist/outline-cli/commit/c2c69d2f1c9eddb08f3f2b0d8236d93770219203))
+
+## [1.10.1](https://github.com/Doist/outline-cli/compare/v1.10.0...v1.10.1) (2026-06-08)
+
+### Bug Fixes
+
+* pin undici to 7.24.8 and block renovate updates ([#82](https://github.com/Doist/outline-cli/issues/82)) ([1f7cdc9](https://github.com/Doist/outline-cli/commit/1f7cdc9d575d1f99968b088abbeafd9182e52c84))
+
+## [1.10.0](https://github.com/Doist/outline-cli/compare/v1.9.0...v1.10.0) (2026-05-24)
+
+### Features
+
+* **auth:** add `token` command group (save + view) ([#80](https://github.com/Doist/outline-cli/issues/80)) ([99789cc](https://github.com/Doist/outline-cli/commit/99789cc48b9afa9fc53959427f9121f8d3c12cd9))
+
+## [1.9.0](https://github.com/Doist/outline-cli/compare/v1.8.0...v1.9.0) (2026-05-24)
+
+### Features
+
+* **account:** account command group (cli-core attachers) ([#79](https://github.com/Doist/outline-cli/issues/79)) ([01bd6a6](https://github.com/Doist/outline-cli/commit/01bd6a60af135bbfda894b56d5a6d2b2229b70a8)), closes [#77](https://github.com/Doist/outline-cli/issues/77)
+
+## [1.8.0](https://github.com/Doist/outline-cli/compare/v1.7.0...v1.8.0) (2026-05-21)
+
+### Features
+
+* **auth:** silent OAuth token refresh ([#75](https://github.com/Doist/outline-cli/issues/75)) ([83996d5](https://github.com/Doist/outline-cli/commit/83996d56810e28e608d91a981fd3b313dcdeb4d3))
+
+## [1.7.0](https://github.com/Doist/outline-cli/compare/v1.6.0...v1.7.0) (2026-05-17)
+
+### Features
+
+* **auth:** store API tokens in the OS keyring via @doist/cli-core ([#73](https://github.com/Doist/outline-cli/issues/73)) ([b353aea](https://github.com/Doist/outline-cli/commit/b353aeae3cdcc63308ec8de899f08c1dda23f22c))
+
+## [1.6.0](https://github.com/Doist/outline-cli/compare/v1.5.3...v1.6.0) (2026-05-15)
+
+### Features
+
+* **auth:** adopt cli-core 0.12.0 multi-user TokenStore shape ([#71](https://github.com/Doist/outline-cli/issues/71)) ([53487b7](https://github.com/Doist/outline-cli/commit/53487b707b9a980c401ef19b3e37c08299aa6abe))
+
+## [1.5.3](https://github.com/Doist/outline-cli/compare/v1.5.2...v1.5.3) (2026-05-11)
+
+### Bug Fixes
+
+* `ol --version` shows the wrong version ([#60](https://github.com/Doist/outline-cli/issues/60)) ([3ed8b10](https://github.com/Doist/outline-cli/commit/3ed8b10d19d727c131b87b2dc6939b5ab0b04a09))
+
+## [1.5.2](https://github.com/Doist/outline-cli/compare/v1.5.1...v1.5.2) (2026-05-09)
+
+### Bug Fixes
+
+* decompress gzipped responses on Node 24+ (undici 7) ([#63](https://github.com/Doist/outline-cli/issues/63)) ([c44fbea](https://github.com/Doist/outline-cli/commit/c44fbeaafa13489505e70d1f829454982f24e07d))
+
+## [1.5.1](https://github.com/Doist/outline-cli/compare/v1.5.0...v1.5.1) (2026-04-02)
+
+### Bug Fixes
+
+* secure config permissions and address update channel review feedback ([#53](https://github.com/Doist/outline-cli/issues/53)) ([63e64f8](https://github.com/Doist/outline-cli/commit/63e64f8b3e54251b74c11f8cbf100339422d43dc))
+
+## [1.5.0](https://github.com/Doist/outline-cli/compare/v1.4.0...v1.5.0) (2026-04-02)
+
+### Features
+
+* allow switching between stable and pre-release update channels ([#52](https://github.com/Doist/outline-cli/issues/52)) ([6834688](https://github.com/Doist/outline-cli/commit/683468819423e93b3f1ca8b38af9ce6788a2e675))
+
+## [1.4.0](https://github.com/Doist/outline-cli/compare/v1.3.0...v1.4.0) (2026-04-02)
+
+### Features
+
+* add `ol changelog` command ([#50](https://github.com/Doist/outline-cli/issues/50)) ([60656e5](https://github.com/Doist/outline-cli/commit/60656e5d816af6080f5084e3f44d0d9763e6c354))
+
+## [1.3.0](https://github.com/Doist/outline-cli/compare/v1.2.1...v1.3.0) (2026-04-02)
+
+### Features
+
+* add `ol update` command ([#49](https://github.com/Doist/outline-cli/issues/49)) ([fa5608e](https://github.com/Doist/outline-cli/commit/fa5608ea50392a71150f7d1140204f0160680d8a))
+
+## [1.2.1](https://github.com/Doist/outline-cli/compare/v1.2.0...v1.2.1) (2026-03-31)
+
+### Bug Fixes
+
+* Capture previous tag before release ([#45](https://github.com/Doist/outline-cli/issues/45)) ([6a00294](https://github.com/Doist/outline-cli/commit/6a002949587a17313f96bc2fb1a93fba7e605e9b))
+
+## [1.2.0](https://github.com/Doist/outline-cli/compare/v1.1.0...v1.2.0) (2026-03-30)
+
+### Features
+
+* Announce releases on Twist ([#44](https://github.com/Doist/outline-cli/issues/44)) ([5e2f86b](https://github.com/Doist/outline-cli/commit/5e2f86b9bf20ca97b50df74f0552028b6f6b94b2))
+
+# [1.1.0](https://github.com/Doist/outline-cli/compare/v1.0.2...v1.1.0) (2026-03-27)
+
+
+### Features
+
+* add --parent option to doc create and doc move ([#41](https://github.com/Doist/outline-cli/issues/41)) ([2514b06](https://github.com/Doist/outline-cli/commit/2514b06e097938b1c0833ea2147509fa0916be28))
+
+## [1.0.2](https://github.com/Doist/outline-cli/compare/v1.0.1...v1.0.2) (2026-03-26)
+
+
+### Bug Fixes
+
+* honor proxy env vars by default ([#33](https://github.com/Doist/outline-cli/issues/33)) ([5bb8e77](https://github.com/Doist/outline-cli/commit/5bb8e77fa8cabe17d2cba478a01c1c64957d7f6b))
+
+## [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,161 @@
-# @todoist/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.
+Requires Node 24+.
 
-## Purpose
+> ```bash
+> npm install -g @todoist/outline-cli
+> ```
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@todoist/outline-cli`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+Previously published as `@doist/outline-cli`. Both packages install the `ol` binary, so uninstall the old one first: `npm uninstall -g @doist/outline-cli`.
 
-## What is OIDC Trusted Publishing?
+### Agent Skills
 
-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.
+Install skills for your coding agent:
 
-## Setup Instructions
+```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
+```
 
-To properly configure OIDC trusted publishing for this package:
+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/`.
 
-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
+```bash
+ol skill list
+ol skill uninstall <agent>
+```
 
-## DO NOT USE THIS PACKAGE
+## Uninstallation
 
-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
+First, remove any installed agent skills:
 
-## More Information
+```bash
+ol skill uninstall <agent>
+```
 
-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)
+Then uninstall the CLI:
 
----
+```bash
+npm uninstall -g @todoist/outline-cli
+```
 
-**Maintained for OIDC setup purposes only**
+## Local Setup
+
+```bash
+git clone https://github.com/todoist/outline-cli.git
+cd outline-cli
+npm install
+npm run build
+npm link
+```
+
+## 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 token <your-api-token>   # save a token (verifies it against your instance)
+ol auth token                    # prompt for the token interactively
+ol auth token view               # print the stored token to stdout (refreshes an expiring OAuth token first)
+```
+
+Generate a token in Outline under Settings → API Tokens. Pass
+`--base-url <your-outline-url>` if the token belongs to a self-hosted instance.
+
+You can also skip storing a token entirely by setting `OUTLINE_API_TOKEN` in
+your environment.
+
+### 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 --offset 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
+cat notes.md | ol document update <urlId> --stdin # reads markdown from stdin
+ol document update <urlId> --publish # publishes a draft
+ol document update <urlId> --publish --collection <id> # publishes a draft that has no collection
+ol document update <urlId> --file updated.md --if-updated-at <updatedAt> # fails if saved since then
+ol document delete <urlId> --confirm
+ol document restore <urlId>          # restores from trash
+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/account.d.ts

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

package/dist/commands/account.js

@@ -0,0 +1,107 @@
+import { emitView } from '@todoist/cli-core';
+import { attachAccountListCommand, attachAccountRemoveCommand, attachAccountUseCommand, } from '@todoist/cli-core/auth';
+import chalk from 'chalk';
+import { TOKEN_ENV_VAR } from '../lib/auth-constants.js';
+import { logClearResult } from '../lib/auth-output.js';
+import { createOutlineTokenStore, resolveActiveAccountSource, } from '../lib/auth-provider.js';
+import { CliError } from '../lib/errors.js';
+import { getRequestedUserRef, isAccessible } from '../lib/global-args.js';
+/** `<label> (id:<id>)` with an accessibility-aware default marker. */
+function accountLine(account, isDefault) {
+    const marker = isDefault ? (isAccessible() ? ' [default]' : chalk.green(' (default)')) : '';
+    return `${account.label} ${chalk.dim(`(id:${account.id})`)}${marker}`;
+}
+/** Tidy machine projection shared by `list` and `current` — drops the OAuth client id. */
+function projectAccount(account, isDefault) {
+    return {
+        id: account.id,
+        label: account.label,
+        teamName: account.teamName,
+        baseUrl: account.baseUrl,
+        isDefault,
+    };
+}
+export function registerAccountCommand(program) {
+    const account = program.command('account').description('Manage stored CLI accounts');
+    const store = createOutlineTokenStore();
+    const list = attachAccountListCommand(account, {
+        store,
+        description: 'List stored Outline accounts',
+        renderText: ({ accounts }) => {
+            if (accounts.length === 0) {
+                return 'No stored accounts. Run `ol auth login` to add one.';
+            }
+            return accounts.map(({ account, isDefault }) => accountLine(account, isDefault));
+        },
+        renderJson: ({ account, isDefault }) => projectAccount(account, isDefault),
+    });
+    attachAccountUseCommand(account, {
+        store,
+        description: 'Set the default account (matched by Outline user id or display name)',
+    });
+    // `current` resolves the active credential's source directly (env / stored /
+    // legacy) rather than going through the generic account attacher, which only
+    // models stored accounts. `--json` / `--ndjson` emit a discriminated envelope.
+    account
+        .command('current')
+        .description('Show the active account (honours --user and OUTLINE_API_TOKEN)')
+        .option('--json', 'Emit machine-readable JSON output')
+        .option('--ndjson', 'Emit machine-readable NDJSON output')
+        .action(async (options) => {
+        const view = { json: Boolean(options.json), ndjson: Boolean(options.ndjson) };
+        const requested = getRequestedUserRef();
+        const resolution = await resolveActiveAccountSource(requested);
+        if (resolution?.source === 'stored') {
+            const { account: acc, isDefault } = resolution;
+            emitView(view, { source: 'stored', account: projectAccount(acc, isDefault) }, () => {
+                const lines = [accountLine(acc, isDefault), `  Base URL: ${acc.baseUrl}`];
+                if (acc.teamName)
+                    lines.push(`  Team: ${acc.teamName}`);
+                return lines;
+            });
+            return;
+        }
+        if (resolution?.source === 'env') {
+            emitView(view, { source: 'env' }, () => [
+                `Using ${TOKEN_ENV_VAR} environment variable (no stored account).`,
+            ]);
+            return;
+        }
+        if (resolution?.source === 'legacy') {
+            emitView(view, { source: 'legacy' }, () => [
+                'Using legacy single-user credentials. Run `ol auth login` to migrate to a stored account.',
+            ]);
+            return;
+        }
+        if (requested !== undefined) {
+            throw new CliError('ACCOUNT_NOT_FOUND', `No stored account matches "${requested}".`, ['Check the account id or display name, or run `ol auth login` to add it.']);
+        }
+        throw new CliError('NOT_AUTHENTICATED', 'Not authenticated. Run: ol auth login');
+    });
+    attachAccountRemoveCommand(account, {
+        store,
+        description: 'Remove a stored account (clears keyring + config entry)',
+        renderText: ({ account, wasDefault }) => {
+            const lines = [`${chalk.green('✓')} Removed ${account.label}`];
+            if (wasDefault) {
+                lines.push(chalk.dim('Cleared default account. Set a new one with `ol account use <id|name>`.'));
+            }
+            return lines;
+        },
+        onRemoved: ({ view }) => logClearResult(store, view.json || view.ndjson),
+    });
+    // Make bare `ol account` list. A parent action runs only when no subcommand
+    // matches, so `ol account list` still routes to the subcommand directly —
+    // this just delegates the no-subcommand case via the public API (no reliance
+    // on commander internals).
+    account.action(async () => {
+        await list.parseAsync([], { from: 'user' });
+    });
+    account.addHelpText('after', `
+Examples:
+  ol account                     # list stored accounts (default subcommand)
+  ol account current             # show the active account
+  ol account use "Ada Lovelace"  # set the default account (id or display name)
+  ol account remove id-bob       # forget an account (clears keyring + config entry)`);
+}
+//# sourceMappingURL=account.js.map