aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-06-24 10:35:21 +0200
committerDanilo M. <danix@danix.xyz>2026-06-24 10:35:21 +0200
commitffe0864406cd67f82071becf494f0dd9e701e149 (patch)
treebed553a5f68dc77e21f16414982f0352b6196d5c /README.md
parent40cd61ce7e0c4a8d35d0e0a505994f9f9b5e4d67 (diff)
downloadgitctl-ffe0864406cd67f82071becf494f0dd9e701e149.tar.gz
gitctl-ffe0864406cd67f82071becf494f0dd9e701e149.zip
docs: document repo-name completion and the server: output prefix
- README: completion note now covers repo-name completion for desc/delete/add-remote, not just --section; new Notes entry on the server: prefix for helper/sync passthrough. - SKILL.md: gotcha explaining that server:-prefixed lines are remote echo (not errors) and that repo list output is not prefixed. Docs only. (The global ~/.claude copy of the skill got the same gotcha, outside the repo.) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/README.md b/README.md
index dbdaf1a..c8475f3 100644
--- a/README.md
+++ b/README.md
@@ -158,7 +158,9 @@ ssh git_push info # gitolite access check
sudo cp completions/gitctl.bash /etc/bash_completion.d/gitctl
```
Or source it from `~/.bashrc`. It completes subcommands and flags, and pulls
- `--section` values live from the server (one ssh call, only after `--section`).
+ live values from the server (one ssh call each, only at the relevant
+ position): section names after `--section`, and repo names for the `desc`,
+ `delete`, and `add-remote` arguments.
6. (Optional) If you drive gitctl through a Claude Code agent, install the
bundled skill so the agent knows when and how to use it:
```
@@ -206,6 +208,9 @@ for the SSH key, so it is not fully unattended.
timestamped) rather than removed, so it is recoverable. It ALWAYS asks for
confirmation; the global `-y` does not bypass it. Idempotent: a piece already
gone is skipped. Prune the trash dir by hand (or a later tool) when sure.
+- Lines from the server helper (and the cgit sync script it runs, e.g.
+ `No changes.`) are echoed with a `server: ` prefix, so it is clear which
+ output is local and which is remote.
- `--desc` never writes cgit `repo.desc=` directly. It writes the bare repo's
`description` file and runs sync, the single writer.
- Every operation is idempotent and safe to re-run.