@tarcisiopgs/lisa 0.9.0 → 0.9.1

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/LICENSE +21 -0
  2. package/README.md +17 -11
  3. package/package.json +2 -1
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Tarcisio Passos
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -4,7 +4,9 @@
4
4
  <img src="src/assets/lisa.png" width="200" alt="Lisa" />
5
5
  </p>
6
6
 
7
- Autonomous issue resolverpicks up issues from Linear or Trello, sends them to an AI coding agent (Claude Code, Gemini CLI, or OpenCode), and opens PRs via the GitHub API. No MCP servers required.
7
+ While the Ralphs of the world flooded GitHub with mindless agent loops brute-forcing their way through issues with no context, no workflow awareness, and no regard for the mess they leave behind — Lisa takes a different approach. She reads the issue, understands the workspace, picks the right repo, creates the branch, validates her work, and opens the PR. Then she moves on to the next one. When there's nothing left to do, she stops.
8
+
9
+ Named after the smartest Simpson, Lisa is an autonomous issue resolver that connects your project tracker (Linear or Trello) to an AI coding agent (Claude Code, Gemini CLI, or OpenCode) and delivers pull requests via the GitHub API. No MCP servers. No prompt chains. No blind retries. Just structured, end-to-end execution.
8
10
 
9
11
  ## Install
10
12
 
@@ -14,7 +16,7 @@ npm install -g @tarcisiopgs/lisa
14
16
 
15
17
  ## Environment Variables
16
18
 
17
- lisa calls external APIs directly. Set these in your shell profile (`~/.zshrc` or `~/.bashrc`):
19
+ Lisa calls external APIs directly. Set these in your shell profile (`~/.zshrc` or `~/.bashrc`):
18
20
 
19
21
  ```bash
20
22
  # Required (always)
@@ -77,7 +79,7 @@ All providers stream output to stdout and to the session log file in real time.
77
79
 
78
80
  ## Workflow Modes
79
81
 
80
- lisa supports two workflow modes, configured during `lisa init`:
82
+ Lisa supports two workflow modes, configured during `lisa init`:
81
83
 
82
84
  ### Branch (default)
83
85
 
@@ -85,9 +87,9 @@ The AI agent creates a branch directly in your current checkout, implements the
85
87
 
86
88
  ### Worktree
87
89
 
88
- lisa creates an isolated [git worktree](https://git-scm.com/docs/git-worktree) for each issue under `.worktrees/`. The AI agent works inside the worktree without touching your main checkout. After the PR is created, the worktree is cleaned up automatically.
90
+ Lisa creates an isolated [git worktree](https://git-scm.com/docs/git-worktree) for each issue under `.worktrees/`. The AI agent works inside the worktree without touching your main checkout. After the PR is created, the worktree is cleaned up automatically.
89
91
 
90
- Worktree mode is ideal when you want to keep working in the repo while lisa resolves issues in the background.
92
+ Worktree mode is ideal when you want to keep working in the repo while Lisa resolves issues in the background.
91
93
 
92
94
  ## Configuration
93
95
 
@@ -167,9 +169,13 @@ lisa run --provider gemini --label "urgent"
167
169
 
168
170
  ## How It Works
169
171
 
170
- 1. **Fetch** — Calls the Linear GraphQL API or Trello REST API to get the next issue matching the configured label, team, and project. Issues are sorted by priority.
171
- 2. **Activate** — Moves the issue to the configured `in_progress` status (e.g. "In Progress") so your team can see it's being worked on.
172
- 3. **Implement** — Builds a prompt with the issue context and sends it to the AI coding agent. In branch mode, the agent creates a branch and works in the current checkout. In worktree mode, lisa creates an isolated worktree first.
173
- 4. **PR** — Creates a pull request via the GitHub API (CLI or token) referencing the original issue. In multi-repo workspaces, the correct repo is detected automatically.
174
- 5. **Update** — Moves the issue to the configured `done` status and removes the pickup label via the source API.
175
- 6. **Loop** — Waits `cooldown` seconds, then picks the next issue. Repeats until no issues remain or the limit is reached.
172
+ 1. **Fetch** — Pulls the next issue from Linear or Trello matching the configured label, team, and project. Issues are sorted by priority.
173
+ 2. **Activate** — Moves the issue to the `in_progress` status so your team knows it's being worked on.
174
+ 3. **Implement** — Builds a structured prompt with full issue context and sends it to the AI agent. The agent creates a branch, implements, validates (lint, typecheck, tests), commits, and pushes.
175
+ 4. **PR** — Detects every repo the agent touched and creates a pull request for each, referencing the original issue. Multi-repo workspaces are handled automatically.
176
+ 5. **Update** — Moves the issue to the `done` status and removes the pickup label.
177
+ 6. **Next** — Picks the next issue. When there are no more issues, Lisa stops. No idle polling, no wasted cycles.
178
+
179
+ ## License
180
+
181
+ [MIT](LICENSE)
package/package.json CHANGED
@@ -1,7 +1,8 @@
1
1
  {
2
2
  "name": "@tarcisiopgs/lisa",
3
- "version": "0.9.0",
3
+ "version": "0.9.1",
4
4
  "description": "Autonomous issue resolver — AI agent loop for Linear/Trello",
5
+ "license": "MIT",
5
6
  "type": "module",
6
7
  "bin": {
7
8
  "lisa": "dist/index.js"