@taskless/cli 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +39 -13
  2. package/dist/index.js +5192 -5291
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -33,13 +33,15 @@ Outputs CLI version, tool status, and login info as JSON to stdout:
33
33
 
34
34
  Launches an interactive wizard that detects supported tool directories in the
35
35
  current project (`.claude/`, `.opencode/`, `.cursor/`, `.agents/`), lets you
36
- pick which ones to install into, optionally includes the `taskless-ci` skill,
37
- and walks through the auth tradeoff before writing anything. Running `taskless`
38
- with no subcommand in a TTY also launches this wizard.
36
+ pick which ones to install into, and walks through the auth tradeoff before
37
+ writing anything. Running `taskless` with no subcommand in a TTY also launches
38
+ this wizard. Without a TTY, bare `taskless` prints a short context preamble
39
+ followed by the topic index from `taskless help`.
39
40
 
40
- For CI and scripted installs, pass `--no-interactive` to skip all prompts.
41
- This installs every mandatory skill to every detected tool, or falls back to
42
- `.agents/skills/` when no tools are detected:
41
+ In v0.7+, there is exactly one skill (`taskless`) and one command (`tskl`) —
42
+ no opt-in selection needed.
43
+
44
+ For CI and scripted installs, pass `--no-interactive` to skip all prompts:
43
45
 
44
46
  ```bash
45
47
  taskless init # interactive wizard (default in a TTY)
@@ -48,8 +50,9 @@ taskless init --no-interactive # scripted install, no prompts
48
50
 
49
51
  The wizard records what it installed in `.taskless/taskless.json` so later
50
52
  runs can compute a diff and surgically remove files that are no longer
51
- selected. Cancelling the wizard at any step (Ctrl-C) aborts cleanly with no
52
- filesystem changes.
53
+ selected. Upgrading from v0.6 automatically removes the obsolete per-task
54
+ skills and commands during this diff. Cancelling the wizard at any step
55
+ (Ctrl-C) aborts cleanly with no filesystem changes.
53
56
 
54
57
  ### `taskless check`
55
58
 
@@ -77,29 +80,52 @@ If every supplied path is missing, the command exits 0 with empty results.
77
80
 
78
81
  Authenticate with taskless.io using the device flow. Tokens are stored in `~/.config/taskless/auth.json`.
79
82
 
80
- ### `taskless rules create`
83
+ ### `taskless rule create`
81
84
 
82
85
  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/`.
83
86
 
84
87
  ```bash
85
- echo '{"prompt": "detect console.log usage"}' | taskless rules create
86
- echo '{"prompt": "find innerHTML assignments", "language": "typescript"}' | taskless rules create --json
88
+ echo '{"prompt": "detect console.log usage"}' | taskless rule create
89
+ echo '{"prompt": "find innerHTML assignments", "language": "typescript"}' | taskless rule create --json
87
90
  ```
88
91
 
89
92
  Requires authentication and a `.taskless/taskless.json` with `orgId` and `repositoryUrl`.
90
93
 
91
- ### `taskless rules delete <id>`
94
+ ### `taskless rule delete <id>`
92
95
 
93
96
  Remove a rule file and its associated test files from disk. No authentication required.
94
97
 
95
98
  ```bash
96
- taskless rules delete no-console-log
99
+ taskless rule delete no-console-log
97
100
  ```
98
101
 
99
102
  ### `taskless --help`
100
103
 
101
104
  Lists available subcommands.
102
105
 
106
+ ### `taskless help [topic]`
107
+
108
+ Returns agent-facing recipes. With no args, prints the topic index. With a
109
+ topic (e.g. `taskless help rule create`), prints the full step-by-step recipe
110
+ for that operation, including an embedded JSON Schema for any `--from` input
111
+ and a table of stable error codes. Append `--anonymous` to fetch the
112
+ local-only variant where one exists (currently `rule create`/`rule improve`).
113
+
114
+ Recipes are how the consolidated `taskless` skill stays small while still
115
+ covering every operation — the skill body is a router that fetches the
116
+ relevant recipe on demand.
117
+
118
+ ### `--anonymous` flag
119
+
120
+ Recognized on every command. Behavior matrix:
121
+
122
+ - `rule create` / `rule improve` — exits with a pointer to
123
+ `taskless help <topic> --anonymous`. The local-only flow runs in the agent
124
+ per the recipe variant.
125
+ - `info` — skips the API/auth probe; reports local state only.
126
+ - `auth login` — rejected (auth commands cannot be anonymous).
127
+ - All others — accepted as no-op.
128
+
103
129
  ## For skill authors
104
130
 
105
131
  Skills should detect the package manager by checking for lock files and invoke the CLI accordingly: