Full Setup with GitHub

A Taskless account unlocks AI-powered rule generation, GitHub integration, and team collaboration features. If you haven’t tried Taskless yet, start with the Quick Start — no account needed.

Sign Up

Taskless uses GitHub to create your account.

1. Go to app.taskless.io and click Log in.
2. You’ll be redirected to GitHub to authorize Taskless.
3. Click Authorize to grant access.
4. You’ll be redirected back to Taskless, logged in and ready to go.

Install the GitHub App

To use Taskless with your repositories, install the Taskless GitHub App on your personal GitHub account or a GitHub organization.

1. Navigate to Organizations in the sidebar.
2. Click Connect an Organization.
3. Select the GitHub account or organization you want to connect and approve the GitHub App installation.

Once installed, Taskless can access your repositories and deliver generated rules as pull requests. The .taskless/ directory is created automatically when you create your first rule.

Note

Taskless works with both personal GitHub accounts and GitHub organizations. For organizations, only owners can install the GitHub App — if you’re not an owner, ask an org admin to connect it.

Create Rules with GitHub Integration

With an account connected, you have additional ways to create rules beyond the local agent workflow.

Via a Pull Request

Mention @taskless in a pull request comment with a description of the rule you want:

@taskless detect console.log calls and suggest using the structured logger instead

Taskless reacts with an eyes emoji to confirm it received the request, then generates a rule and opens a new PR with the result. The generated PR links back to the original for easy cross-referencing.

Inline review comments work too. Taskless uses the file path, line number, and diff context to generate more targeted rules.

Via an Issue

Mention @taskless in a GitHub issue to generate a rule from the issue description. This is useful when you want to describe a pattern to catch without being in the context of a specific PR.

Via the Dashboard

1. Click + New Rule in the sidebar (or go to /rules/new).
2. Select an organization and repository.
3. Describe the rule you want, including what pattern to detect and what to suggest instead.
4. Optionally provide good and bad code examples for better results.
5. Submit the request.

Taskless generates the rule and opens a PR on your repository with the result.

In Your IDE Using Agent Skills

If you have Taskless agent skills installed (see Agent Skills), authenticated rule creation uses Taskless’ API for higher-quality generation with validation and test cases. Ask your coding agent:

“Create a taskless rule that catches direct fetch() calls without error handling”

When logged in, the agent uses the Taskless API under the hood. When not logged in, it falls back to local static analysis rule generation.

For advice on writing effective rule descriptions, see Tips for Better Rules.