Taskless

https://docs.taskless.io
Admin
Taskless turns corrections into rules so the same mistake never slows you down twice.
Tokens:4,890
Snippets:86
Trust Score:5.9
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Taskless CLI

Source: https://docs.taskless.io/agent-skills/installing-the-cli

Run the Taskless CLI using npx. No global installation is required.

```bash
npx @taskless/cli <command>
```

--------------------------------

### Onboard with Taskless CLI

Source: https://docs.taskless.io/technologies/taskless-cli

Run this guided post-install pass to surface potential rule candidates from your project.

```bash
npx @taskless/cli onboard
```

--------------------------------

### Install or Update Taskless CLI

Source: https://docs.taskless.io/technologies/taskless-cli

Run this command to install or update the Taskless skill in your repository. It can be executed without any arguments.

```bash
npx @taskless/cli
```

--------------------------------

### Install Taskless CLI

Source: https://docs.taskless.io/getting-started

Run this command in any repository with a configured coding agent to install the Taskless skill. This command works with npm, pnpm, bun, and yarn.

```bash
npx @taskless/cli init
```

--------------------------------

### Create a Rule from the CLI (Bash)

Source: https://docs.taskless.io/rules/creating-rules

Invoke the Taskless CLI to create a new rule. The `--from` flag points to a JSON file that describes the rule generation prompt and provides example cases.

```bash
npx @taskless/cli rule create --from <file>
```

--------------------------------

### Check Taskless CLI Status

Source: https://docs.taskless.io/agent-skills/installing-the-cli

Verify the Taskless CLI installation and check authentication status by running the info command.

```bash
npx @taskless/cli info
```

--------------------------------

### Update Taskless CLI

Source: https://docs.taskless.io/agent-skills/installing-skills

Use this non-interactive command for CI environments or re-running installations across multiple machines. It updates existing skills to the latest version.

```bash
npx @taskless/cli update
```

--------------------------------

### Fetch Taskless Recipe for Agent

Source: https://docs.taskless.io/agent-skills/what-are-agent-skills

Agents use this command to fetch the current recipe for a given topic. This allows the agent to understand and execute Taskless tasks based on the latest CLI version.

```bash
npx @taskless/cli help <topic>
```

--------------------------------

### Manage Taskless Authentication

Source: https://docs.taskless.io/technologies/taskless-cli

Use this command to manage your authentication with taskless.io.

```bash
npx @taskless/cli auth
```

--------------------------------

### Manage Taskless Rules

Source: https://docs.taskless.io/technologies/taskless-cli

Commands for creating, improving, and deleting rules within the Taskless system.

```bash
npx @taskless/cli rule
```

--------------------------------

### Check Code with Taskless Rules

Source: https://docs.taskless.io/getting-started

Execute this command to run all your Taskless rules against your codebase. The command exits with code 1 on error-severity matches, making it ideal for CI.

```bash
npx @taskless/cli check
```

--------------------------------

### Rule Creation JSON Configuration

Source: https://docs.taskless.io/rules/creating-rules

This JSON structure defines the parameters for generating a rule via the CLI. Include a prompt, and optionally success and failure cases for the rule.

```json
{
  "prompt": "Flag console.log calls in production code",
  "successCases": ["logger.info('request received')"],
  "failureCases": ["console.log('debug value:', x)"]
}
```

--------------------------------

### Authenticate with Taskless CLI

Source: https://docs.taskless.io/agent-skills/installing-the-cli

Log in to Taskless using a browser-based device flow for commands requiring authentication. Follow the on-screen URL and code prompts.

```bash
npx @taskless/cli auth login
```

--------------------------------

### Generate New Rule from File

Source: https://docs.taskless.io/agent-skills/installing-the-cli

Use the `--anonymous` flag to force local-only behavior for rule creation, bypassing the Taskless API. This is useful for local development or when API access is not desired.

```bash
npx @taskless/cli rule create --from request.json --anonymous
```

--------------------------------

### Run Taskless Rules with JSON Output

Source: https://docs.taskless.io/rules/checking-rules

Generate machine-readable JSON output for Taskless rule checks. This format is useful for integrating with other tools or CI systems.

```bash
npx @taskless/cli check --json
```

--------------------------------

### Improve a Taskless Rule

Source: https://docs.taskless.io/rules/improving-rules

Use this command to send feedback and updated rule definitions to Taskless for regeneration. The `--from` flag specifies the JSON file containing your improvement request.

```bash
npx @taskless/cli rule improve --from <file>
```

--------------------------------

### Taskless CLI with JSON Output

Source: https://docs.taskless.io/technologies/taskless-cli

When the `--json` flag is passed, the CLI emits a stable error shape with a `code` field upon failure. This allows recipes to branch on specific error codes.

```bash
npx @taskless/cli --json <command>
```

--------------------------------

### Define a Syntax-Tree Based Rule (YAML)

Source: https://docs.taskless.io/rules/creating-rules

Use this format to define syntax-tree based rules. Specify the rule ID, target language, the pattern to match, severity, a message, and an optional auto-fix.

```yaml
id: no-console-log
language: TypeScript
rule:
  pattern: console.log($$$ARGS)
severity: warning
message: Avoid console.log in production code. Use a structured logger instead.
fix: logger.info($$$ARGS)
```

--------------------------------

### Integrate Taskless Rule Checks into GitHub Actions

Source: https://docs.taskless.io/rules/checking-rules

Add a step to your GitHub Actions workflow to automatically check Taskless rules on every pull request. The pipeline will fail if any rules are violated due to the non-zero exit code on error.

```yaml
# GitHub Actions example
- name: Check Taskless rules
  run: npx @taskless/cli check
```

--------------------------------

### Taskless CLI with Anonymous Flag

Source: https://docs.taskless.io/technologies/taskless-cli

The `--anonymous` flag forces local-only behavior for `rule create` and `rule improve`, skipping the Taskless API. It is a no-op on most other commands and errors on `auth login`.

```bash
npx @taskless/cli rule create --anonymous
```

--------------------------------

### Taskless Rule Improvement Request JSON

Source: https://docs.taskless.io/rules/improving-rules

This JSON format is used to request improvements for a Taskless rule. Include the `ruleId`, a `guidance` string describing the desired changes, and optionally `references` to relevant files with their content.

```json
{
  "ruleId": "no-triple-slash-reference",
  "guidance": "Also flag /// <reference lib=... /> directives, not just types and path",
  "references": [
    {
      "filename": "src/worker.ts",
      "content": "/// <reference lib=\"es2015\" />\nimport { Hono } from 'hono';"
    }
  ]
}
```

--------------------------------

### Log Out from Taskless CLI

Source: https://docs.taskless.io/agent-skills/installing-the-cli

Clear stored authentication credentials from the Taskless CLI.

```bash
npx @taskless/cli auth logout
```
Tokens:
Raw