@obsfx/trekker 1.2.0 → 1.2.2
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.
- package/README.md +21 -6
- package/dist/index.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Trekker
|
|
2
2
|
|
|
3
|
-
A CLI issue tracker built for AI coding agents. Stores tasks, epics, and dependencies in a local SQLite database
|
|
3
|
+
A CLI issue tracker built for AI coding agents. Stores tasks, epics, and dependencies in a local SQLite database. No server required.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
@@ -24,7 +24,7 @@ My concerns about the future and security of that project led me here. Trekker i
|
|
|
24
24
|
|
|
25
25
|
What you get:
|
|
26
26
|
- Task and epic tracking with dependencies
|
|
27
|
-
-
|
|
27
|
+
- Optional kanban board UI available as a [separate package](https://github.com/obsfx/trekker-dashboard)
|
|
28
28
|
- No special directory required. The .trekker folder stays local to your project.
|
|
29
29
|
- No hook integrations. Just task management.
|
|
30
30
|
|
|
@@ -133,13 +133,26 @@ trekker-dashboard -p 3000 # Start dashboard on port 3000
|
|
|
133
133
|
|
|
134
134
|
The dashboard shows tasks grouped by status and reads from the same `.trekker/trekker.db` database.
|
|
135
135
|
|
|
136
|
-
##
|
|
136
|
+
## Claude Code Integration
|
|
137
137
|
|
|
138
|
-
|
|
138
|
+
For seamless integration with [Claude Code](https://claude.ai/code), install the Trekker plugin:
|
|
139
139
|
|
|
140
140
|
```bash
|
|
141
|
-
|
|
142
|
-
|
|
141
|
+
claude /plugin marketplace add obsfx/trekker-claude-code
|
|
142
|
+
claude /plugin install trekker
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
This gives Claude Code native access to Trekker commands through MCP. The agent can create tasks, update status, and manage dependencies without running CLI commands directly.
|
|
146
|
+
|
|
147
|
+
See [trekker-claude-code](https://github.com/obsfx/trekker-claude-code) for more details.
|
|
148
|
+
|
|
149
|
+
## TOON Output
|
|
150
|
+
|
|
151
|
+
Add the `--toon` flag to any command for structured output in [TOON format](https://github.com/tooners/toon). TOON is a token-efficient serialization format designed for AI agents, using fewer tokens than JSON while remaining machine-readable:
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
trekker --toon task list
|
|
155
|
+
trekker --toon task show TREK-1
|
|
143
156
|
```
|
|
144
157
|
|
|
145
158
|
## Status Values
|
|
@@ -175,6 +188,8 @@ Run `trekker quickstart` to see the full guide with best practices for creating
|
|
|
175
188
|
|
|
176
189
|
This is my personal workflow for getting the most out of Trekker with AI agents:
|
|
177
190
|
|
|
191
|
+
- **Install the Claude Code plugin.** I use [trekker-claude-code](https://github.com/obsfx/trekker-claude-code) to give Claude Code direct access to Trekker through MCP. This way, the agent manages tasks natively without running CLI commands.
|
|
192
|
+
|
|
178
193
|
- **Always mention Trekker in prompts.** I include "use trekker" in my instructions so the agent knows to track its work.
|
|
179
194
|
|
|
180
195
|
- **Point agents to the quickstart.** I tell the agent it can run `trekker quickstart` to learn how to use Trekker properly. This gives it all the context it needs without me having to explain everything.
|
package/dist/index.js
CHANGED
|
@@ -310,7 +310,7 @@ function wipeProject(cwd = process.cwd()) {
|
|
|
310
310
|
deleteDb(cwd);
|
|
311
311
|
}
|
|
312
312
|
|
|
313
|
-
// node_modules
|
|
313
|
+
// node_modules/@toon-format/toon/dist/index.mjs
|
|
314
314
|
var LIST_ITEM_MARKER = "-";
|
|
315
315
|
var LIST_ITEM_PREFIX = "- ";
|
|
316
316
|
var COMMA = ",";
|
|
@@ -2073,7 +2073,7 @@ Seed complete! Created ${epicIds.length} epics, ${taskIds.length} tasks, ${SAMPL
|
|
|
2073
2073
|
// package.json
|
|
2074
2074
|
var package_default = {
|
|
2075
2075
|
name: "@obsfx/trekker",
|
|
2076
|
-
version: "1.2.
|
|
2076
|
+
version: "1.2.2",
|
|
2077
2077
|
description: "A CLI-based issue tracker built for AI coding agents. Stores tasks, epics, and dependencies in a local SQLite database.",
|
|
2078
2078
|
type: "module",
|
|
2079
2079
|
main: "dist/index.js",
|
package/package.json
CHANGED