Skip to content

Simplifies the CLI README - #129

Merged
thecodedrift merged 3 commits into
mainfrom
chore/readme-fixes
Aug 21, 2026
Merged

Simplifies the CLI README#129
thecodedrift merged 3 commits into
mainfrom
chore/readme-fixes

Conversation

@thecodedrift

Copy link
Copy Markdown
Member

The CLI README had a bunch of information that was not useful. This pares it down to the bare minimum for simplicity. Will receive updates with additional info

Copilot AI lite review requested due to automatic review settings August 21, 2026 01:09
@thecodedrift
thecodedrift marked this pull request as draft August 21, 2026 01:09

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR significantly reduces the @taskless/cli README to a minimal “what it is / how to run it / where to learn more” document, aligning with the stated goal of removing less-useful detail for now.

Changes:

  • Replaces the long-form README (commands, JSON examples, developer/testing notes) with a short description and minimal usage snippet.
  • Updates the usage examples to show invoking the package directly via npx / pnpm dlx.
  • Adds a single pointer to the Taskless docs site for further documentation.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@thecodedrift thecodedrift mentioned this pull request Aug 21, 2026
@thecodedrift

Copy link
Copy Markdown
Member Author

Pushed 347da73 — builds the README back up per #130, in the section order the issue asked for: Install, How to Use via Agents, Taskless Check (CI and Constraints), Why Teams Choose Taskless, Docs, a collapsible Other holding Telemetry, and MIT as a footnote. ~90 lines total, links out rather than inlining reference material.

Everything factual is verified against source rather than recalled:

  • install command / package name / bin: tasklesspackages/cli/package.json
  • subcommand surface — the built CLI's own --help
  • check flags, exit codes, path filtering, runtime-rule gating — packages/cli/src/commands/check.ts
  • tool detection (Claude Code, Cursor, OpenCode, .agents/ fallback; slash command only where supported) — packages/cli/src/install/install.ts
  • telemetry opt-out TASKLESS_TELEMETRY_DISABLED=1 / DO_NOT_TRACK=1packages/cli/src/telemetry.ts

Only packages/cli/README.md changed. The nightly ships a fully generated README (buildNightlyReadme in .github/scripts/nightly-pack.cjs) that replaces this one, so nothing there needs to stay in sync.

pnpm lint, pnpm typecheck, pnpm test (630 tests, 51 files) and prettier on the README all pass.

@thecodedrift
thecodedrift marked this pull request as ready for review August 21, 2026 05:51
thecodedrift and others added 3 commits August 20, 2026 22:51
Builds on the pared-down README with the sections the redesign called
for: Install, How to Use via Agents, Taskless Check (CI and
constraints), Why Teams Choose Taskless, Docs, a collapsible Other
section covering telemetry and its opt-out, and MIT as a footnote.

Every command, flag, and env var is taken from source rather than
recalled: the install/bin name from packages/cli/package.json, the
subcommand list from the built CLI's own --help, the check flags and
exit behavior from src/commands/check.ts, the tool detection list from
src/install/install.ts, and the telemetry opt-out
(TASKLESS_TELEMETRY_DISABLED / DO_NOT_TRACK) from src/telemetry.ts.

Fixes #130

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jwc9FFroR3mTZ4hLiSkkX3
The README ships inside the published tarball — npm includes it
regardless of `files` — so the rewrite reaches users and earns a
release note. Patch level: the repo is pre-1.0 and no behavior changed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jwc9FFroR3mTZ4hLiSkkX3
@thecodedrift
thecodedrift merged commit 1fb9dda into main Aug 21, 2026
2 checks passed
@thecodedrift
thecodedrift deleted the chore/readme-fixes branch August 21, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants