Lisa自动化问题解决器

Goose backend (required when provider: goose)

GOOSE_PROVIDER="" # gemini-cli, anthropic, openai, google, ollama GOOSE_MODEL="" # model name for the selected backend

Quickstart

npm install -g @tarcisiopgs/lisa
lisa init    # interactive setup wizard
lisa         # start the agent loop

Configuration

Config lives in .lisa/config.yaml. Run lisa init to create it interactively.

provider: claude
source: linear
workflow: worktree       # "worktree" (isolated) or "branch" (in-place)

source_config:
  scope: Engineering
  project: Web App
  label: ready              # or array: [ready, urgent]
  remove_label: ready       # label to remove on completion (defaults to label)
  pick_from: Backlog
  in_progress: In Progress
  done: In Review

bell: true                  # terminal bell on issue completion

platform: cli            # "cli" (gh), "token" (GITHUB_TOKEN), "gitlab", "bitbucket"
base_branch: main

<details> <summary><strong>Environment variables</strong></summary>

```bash

Self-hosted instances (optional)

PLANE_BASE_URL="" # default: https://api.plane.so GITLAB_BASE_URL="" # default: https://gitlab.com PLANE_WORKSPACE="" # fallback for source_config.scope

Configurable reactions (override defaults)

reactions: ci_failed: action: reinvoke # reinvoke | notify | skip max_retries: 3 escalate_after: 30m changes_requested: action: reinvoke max_retries: 2 escalate_after: 1h approved: action: notify agent_stuck: action: notify validation_failed: action: reinvoke max_retries: 2

progress_comments: enabled: true # post real-time status on issues

pr: reviewers: # auto-request reviews on every PR - octocat - hubot assignees: # auto-assign PRs ("self" = authenticated user) - self

hooks: before_run: "./scripts/setup.sh" after_run: "./scripts/cleanup.sh" timeout: 60000 # ms, default 60000 ```

</details>

AI provider API keys (used by Aider / Goose / wizard auto-detection)

ANTHROPIC_API_KEY="" OPENAI_API_KEY="" GEMINI_API_KEY="" GOOGLE_API_KEY="" # for Goose with goose_provider: google

</details>

<details>
<summary><strong>Source-specific configuration</strong></summary>

| Field | Linear | Trello | Plane | Shortcut | GitLab Issues | GitHub Issues | Jira |
|-------|--------|--------|-------|----------|---------------|---------------|------|
| `scope` | Team name | Board name | Workspace slug | — | Project path | `owner/repo` | Project key |
| `project` | Project name | — | Project ID | — | — | — | — |
| `pick_from` | Status name | List name | State name | Workflow state | — | — | Status name |
| `label` | Label | Label | Label | Label | Label | Label | Label |
| `remove_label` | Label | Label | Label | Label | — | — | — |
| `in_progress` | Status | Column | State | Workflow state | Label | Label | Status |
| `done` | Status | Column | State | Workflow state | Closes issue | Closes issue | Status |

</details>

<details>
<summary><strong>Multi-repo setup</strong></summary>

Lisa runs a planning phase, then executes steps sequentially — one worktree and one PR per repo.

</details>

<details>
<summary><strong>Advanced options</strong></summary>

overseer: enabled: true check_interval: 30 # seconds between git status checks stuck_threshold: 300 # kill provider after this many seconds without changes

lifecycle: mode: auto # "auto", "skip" (default), "validate-only" timeout: 30

proof_of_work: enabled: true block_on_failure: true # skip PR when validation fails (default: false) max_retries: 2 # retry agent on validation failure commands: - name: lint run: pnpm run lint - name: typecheck run: pnpm run typecheck - name: test run: pnpm run test

validation: require_acceptance_criteria: true

spec_compliance: enabled: true max_retries: 1 # retry agent to fix unmet criteria (default: 1) block_on_failure: true # skip PR when criteria aren't met (default: false)

ci_monitor: enabled: true max_retries: 3 # fix attempts on CI failure poll_interval: 30 # seconds between CI status checks poll_timeout: 600 # max seconds to wait for CI block_on_failure: false # revert issue if CI never passes

Validation Pipeline

After the agent implements an issue, Lisa runs a multi-stage validation pipeline before creating a PR:

Agent implements → Proof of Work (lint/test/typecheck) → Spec Compliance → PR → CI Monitor → Review Monitor

Proof of Work runs configured shell commands (lint, typecheck, test). If any fail, the agent is re-invoked with the error output to fix the issue.

Spec Compliance extracts acceptance criteria from the issue description (- [ ] checklists) and asks the LLM to verify each one against the git diff. The result is a structured JSON with met/not-met verdicts and evidence. If criteria are unmet, the agent is re-invoked to fix them. Results are appended to the PR body as a Markdown table:

Both stages support max_retries and block_on_failure — when blocking is enabled, the PR is skipped entirely on failure.