@taskless/cli 0.6.0 → 0.8.0

package/README.md

@@ -32,14 +32,23 @@ Outputs CLI version, tool status, and login info as JSON to stdout:
 ### `taskless init`
 
 Launches an interactive wizard that detects supported tool directories in the
-current project (`.claude/`, `.opencode/`, `.cursor/`, `.agents/`), lets you
-pick which ones to install into, optionally includes the `taskless-ci` skill,
-and walks through the auth tradeoff before writing anything. Running `taskless`
-with no subcommand in a TTY also launches this wizard.
+current project (`.claude/`, `.opencode/`, `.cursor/`, `.agents/`), asks which
+tools to enable Taskless for, and walks through the auth tradeoff before
+writing anything. Running `taskless` with no subcommand in a TTY also launches
+this wizard. Without a TTY, bare `taskless` prints a short context preamble
+followed by the topic index from `taskless help`.
 
-For CI and scripted installs, pass `--no-interactive` to skip all prompts.
-This installs every mandatory skill to every detected tool, or falls back to
-`.agents/skills/` when no tools are detected:
+In v0.7+, there is exactly one skill (`taskless`) and one command (`tskl`) —
+no opt-in selection needed.
+
+The skill and command content is written **once** to a canonical store in
+`.taskless/skills/` and `.taskless/commands/`. Each enabled tool directory
+receives only a thin reference stub — an ordinary file with a delegating body,
+never a symlink — so there is a single source of truth and no drift between
+copies. Stale layouts from earlier versions (full per-tool copies, symlinks)
+are converged into stubs automatically on the next `init`/`update`.
+
+For CI and scripted installs, pass `--no-interactive` to skip all prompts:
 
 ```bash
 taskless init                    # interactive wizard (default in a TTY)
@@ -48,8 +57,41 @@ taskless init --no-interactive   # scripted install, no prompts
 
 The wizard records what it installed in `.taskless/taskless.json` so later
 runs can compute a diff and surgically remove files that are no longer
-selected. Cancelling the wizard at any step (Ctrl-C) aborts cleanly with no
-filesystem changes.
+selected. Upgrading from v0.6 automatically removes the obsolete per-task
+skills and commands during this diff. Cancelling the wizard at any step
+(Ctrl-C) aborts cleanly with no filesystem changes.
+
+### `taskless onboard`
+
+Post-install discovery flow that helps a fresh user go from zero rules to a
+useful starter set. Run it after `taskless init`. The CLI prints an
+agent-facing recipe that walks the host AI tool through scanning the
+codebase, agent-memory files (CLAUDE.md / AGENTS.md / .cursorrules),
+recent PR review comments (when `gh` is available), and issue tracker
+tickets (when a relevant MCP is wired in) for high-signal rule
+candidates, then surfaces them as a bullet list the user can choose to
+materialize via `taskless rule create`.
+
+```bash
+taskless onboard                  # print the recipe (refused if already complete)
+taskless onboard --force          # re-run even when previously marked complete
+taskless onboard --mark-complete  # record completion in .taskless/taskless.json
+                                  # (invoked by the agent after explicit user
+                                  # confirmation; never automatically)
+```
+
+Onboarding state lives in `.taskless/taskless.json` as
+`install.onboarded` — a 3-state optional field (absent / `false` / `true`).
+Only the agent writes it, and only with the user's explicit confirmation.
+`taskless init` does not set it. Pass `--force` to re-run regardless of the
+current value.
+
+After a successful `taskless init`, the CLI prints a one-line trailer
+pointing the user at this command. The trailer wording adapts to the
+install plan: when the install included slash commands (Claude Code or
+Cursor), it mentions `/tskl onboard` along with the Taskless skill and the
+bare CLI; when the install only wrote skills (OpenCode, Codex, the
+`.agents/` fallback), it mentions the skill and the bare CLI only.
 
 ### `taskless check`
 
@@ -77,29 +119,52 @@ If every supplied path is missing, the command exits 0 with empty results.
 
 Authenticate with taskless.io using the device flow. Tokens are stored in `~/.config/taskless/auth.json`.
 
-### `taskless rules create`
+### `taskless rule create`
 
 Generate ast-grep rules via the taskless.io API. Reads a JSON request from stdin, submits it, polls for results, and writes rule and test files to `.taskless/rules/` and `.taskless/rule-tests/`.
 
 ```bash
-echo '{"prompt": "detect console.log usage"}' | taskless rules create
-echo '{"prompt": "find innerHTML assignments", "language": "typescript"}' | taskless rules create --json
+echo '{"prompt": "detect console.log usage"}' | taskless rule create
+echo '{"prompt": "find innerHTML assignments", "language": "typescript"}' | taskless rule create --json
 ```
 
 Requires authentication and a `.taskless/taskless.json` with `orgId` and `repositoryUrl`.
 
-### `taskless rules delete <id>`
+### `taskless rule delete <id>`
 
 Remove a rule file and its associated test files from disk. No authentication required.
 
 ```bash
-taskless rules delete no-console-log
+taskless rule delete no-console-log
 ```
 
 ### `taskless --help`
 
 Lists available subcommands.
 
+### `taskless help [topic]`
+
+Returns agent-facing recipes. With no args, prints the topic index. With a
+topic (e.g. `taskless help rule create`), prints the full step-by-step recipe
+for that operation, including an embedded JSON Schema for any `--from` input
+and a table of stable error codes. Append `--anonymous` to fetch the
+local-only variant where one exists (currently `rule create`/`rule improve`).
+
+Recipes are how the consolidated `taskless` skill stays small while still
+covering every operation — the skill body is a router that fetches the
+relevant recipe on demand.
+
+### `--anonymous` flag
+
+Recognized on every command. Behavior matrix:
+
+- `rule create` / `rule improve` — exits with a pointer to
+  `taskless help <topic> --anonymous`. The local-only flow runs in the agent
+  per the recipe variant.
+- `info` — skips the API/auth probe; reports local state only.
+- `auth login` — rejected (auth commands cannot be anonymous).
+- All others — accepted as no-op.
+
 ## For skill authors
 
 Skills should detect the package manager by checking for lock files and invoke the CLI accordingly: