From ffe0864406cd67f82071becf494f0dd9e701e149 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Wed, 24 Jun 2026 10:35:21 +0200 Subject: 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 --- README.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'README.md') 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. -- cgit v1.2.3