aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-19 12:03:27 +0200
committerDanilo M. <danix@danix.xyz>2026-10-19 12:03:27 +0200
commit6cb503a50fc49ec26af0f0624141a0c97e75cca4 (patch)
treef54c49fe2ef219166110cabdb803b21178531e80
parent702117ef9557503fd67ac17db9e1a89a7c67e0a9 (diff)
downloaddesktop-assistant-6cb503a50fc49ec26af0f0624141a0c97e75cca4.tar.gz
desktop-assistant-6cb503a50fc49ec26af0f0624141a0c97e75cca4.zip
docs: the new project tool, live check
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
-rw-r--r--AGENTS.md28
-rw-r--r--docs/superpowers/specs/2026-10-19-project-tool-design.md2
2 files changed, 29 insertions, 1 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 1002a3b..7e80210 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -188,6 +188,34 @@ no `data:` prefix), no whisper. The 10 clips in
- A Unix socket path is limited to 108 bytes: a test socket under a deep
scratch directory fails with `AF_UNIX path too long`.
+### New project tool, live check (2026-10-19)
+
+`project` (`examples/tools/project.sh`): a folder in `~/Programming/GIT`
+with AGENTS.md, CLAUDE.md, README.md and LICENSE (texts in
+`examples/tools/licenses/`, installed next to the script), a signed
+first commit, then Claude Code or opencode in a kitty tab. Spec:
+`docs/superpowers/specs/2026-10-19-project-tool-design.md`.
+
+- The confirmation lives in the tool description only: 5 phrasings,
+ it/en, 5/5 repeated name, description, license and agent and asked
+ first, no tool call, no folder. MIT, GPLv3 and opencode picked up when
+ named, defaults otherwise.
+- "Yes." then called it in 5.8 s: folder, commit `G`, tab in the
+ running kitty with the prompt.
+- The model drops the description's final period; the prompt adds it
+ back (`${desc%.}.`).
+- The tab needs kitty remote control (`kitty-conf`: `allow_remote_control
+ socket-only`, `listen_on unix:${XDG_RUNTIME_DIR}/kitty-{kitty_pid}`),
+ live only after a kitty restart. No socket answers: `setsid -f kitty
+ -d`, a new window. Faking "no kitty" with a scratch `XDG_RUNTIME_DIR`
+ also hides the Wayland socket and the window dies: test the fallback
+ with the real runtime dir.
+- opencode 2.0.28's full TUI has no `--agent` (only `mini` and `run`),
+ and `OPENCODE_CONFIG`/`OPENCODE_CONFIG_CONTENT` from the client are not
+ seen: config loads in the background service. So `default_agent =
+ "plan"` is set in the global opencode config (`opencode reload`), and
+ the opencode prompt asks plan, which cannot edit, to propose.
+
### Desktop modes tool, live check (2026-10-19)
`mode` (`examples/tools/mode.sh`, statusctl): the first tool that writes.
diff --git a/docs/superpowers/specs/2026-10-19-project-tool-design.md b/docs/superpowers/specs/2026-10-19-project-tool-design.md
index 0fed3c5..51aceb6 100644
--- a/docs/superpowers/specs/2026-10-19-project-tool-design.md
+++ b/docs/superpowers/specs/2026-10-19-project-tool-design.md
@@ -1,6 +1,6 @@
# New project tool: design
-Date: 2026-10-19. Status: approved, not implemented.
+Date: 2026-10-19. Status: implemented (2026-10-19).
## Goal