@trailkeep/cli 0.5.0 → 0.5.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.
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +2 -2
- package/bin/trailkeep +2 -2
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "trailkeep",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.1",
|
|
4
4
|
"description": "Injects your private repo notes and the current branch's effort file at session start, plus the effort skill.",
|
|
5
5
|
"author": { "name": "Mario Širić" },
|
|
6
6
|
"repository": "https://github.com/msiric/trailkeep",
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Context for coding agents that works the same in **Claude Code**, **Codex CLI** and **GitHub Copilot CLI**. It keeps three kinds of knowledge apart: what's always true about you, what's always true about a repo, and what matters only for the branch you're on. It also keeps an append-only log of why things were decided.
|
|
4
4
|
|
|
5
|
-
It's a single POSIX shell script that needs only `git`. It never changes your repos' tracked files. In a repo with no notes, effort or log, it adds one short capture rule to a session (about
|
|
5
|
+
It's a single POSIX shell script that needs only `git`. It never changes your repos' tracked files. In a repo with no notes, effort or log, it adds one short capture rule to a session (about 130 tokens), and nothing at all with `TRAILKEEP_HINT=0`.
|
|
6
6
|
|
|
7
7
|
## Install (one command, once per machine)
|
|
8
8
|
|
|
@@ -42,7 +42,7 @@ Later, `trailkeep update` gets the latest version the same way you installed it
|
|
|
42
42
|
| When | What happens automatically |
|
|
43
43
|
|---|---|
|
|
44
44
|
| Any session starts in any repo | Notes and the branch's effort file are injected. A one-line pointer mentions the decision log if it has entries. Leftovers from a session that didn't exit cleanly are logged first. |
|
|
45
|
-
| Any session starts in a repo | A short capture rule tells the agent to record decisions, user rules and dead ends the moment they come up, with `trailkeep note`, and to pick the scope: this branch, the whole repo (`--repo`) or every repo (`--all`). It doesn't wait for anyone to decide the task "spans sessions". Turn it off with `TRAILKEEP_HINT=0`. |
|
|
45
|
+
| Any session starts in a repo | A short capture rule tells the agent to record decisions, user rules and dead ends the moment they come up and to check before finishing a task that nothing is left unrecorded, with `trailkeep note`, and to pick the scope: this branch, the whole repo (`--repo`) or every repo (`--all`). It doesn't wait for anyone to decide the task "spans sessions". Turn it off with `TRAILKEEP_HINT=0`. |
|
|
46
46
|
| You're on a branch with no notes yet | The last few decisions recorded on other branches are shown, each labelled with its branch, so repo-wide rules saved on one branch aren't lost on the next. Once the branch has its own notes, only those are shown. |
|
|
47
47
|
| The agent works | It keeps the effort file current: plan ticks, a progress line per session, decisions and dead ends. That's the effort skill's job. |
|
|
48
48
|
| Context gets compacted | The effort file is re-injected fresh. |
|
package/bin/trailkeep
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
|
|
6
6
|
set -u
|
|
7
7
|
|
|
8
|
-
VERSION="0.5.
|
|
8
|
+
VERSION="0.5.1"
|
|
9
9
|
PKG="@trailkeep/cli"
|
|
10
10
|
MARKER="managed by trailkeep"
|
|
11
11
|
|
|
@@ -230,7 +230,7 @@ default_branch() {
|
|
|
230
230
|
# One standing instruction, so capture doesn't depend on the agent deciding a
|
|
231
231
|
# task "spans sessions" (it can't know). Measured cost: about 110 tokens.
|
|
232
232
|
capture_rule() {
|
|
233
|
-
printf '%s\n' 'trailkeep: when something comes up that a later session must not lose (a decision and its reason, a rule or preference the user states, an approach that failed and why), record it right away with its reason. Pick the scope: `trailkeep note --repo "..."` for a rule about this codebase that holds on every branch, `trailkeep note "..."` for something specific to this branch'"'"'s task, `trailkeep note --all "..."` for a personal preference in every repo. Notes are shown at the start of the next session.'
|
|
233
|
+
printf '%s\n' 'trailkeep: when something comes up that a later session must not lose (a decision and its reason, a rule or preference the user states, an approach that failed and why), record it right away with its reason. Before you finish a task, check that nothing from this session is left unrecorded. Pick the scope: `trailkeep note --repo "..."` for a rule about this codebase that holds on every branch, `trailkeep note "..."` for something specific to this branch'"'"'s task, `trailkeep note --all "..."` for a personal preference in every repo. Notes are shown at the start of the next session.'
|
|
234
234
|
}
|
|
235
235
|
|
|
236
236
|
# Decisions recorded on other branches, newest first: effort files in this
|
package/package.json
CHANGED