aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md7
-rw-r--r--skills/gitctl/SKILL.md3
2 files changed, 9 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.
diff --git a/skills/gitctl/SKILL.md b/skills/gitctl/SKILL.md
index a37c1f7..a340546 100644
--- a/skills/gitctl/SKILL.md
+++ b/skills/gitctl/SKILL.md
@@ -71,6 +71,9 @@ git push -u origin master
- **`--desc` is the only way to set a cgit description.** It writes the bare
repo's `description` file and runs the sync script (the single writer of
`repo.desc=`). Never write `repo.desc=` directly.
+- **Output prefixed `server: ` is the helper/sync script talking, not gitctl.**
+ Lines like `server: No changes.` during create/delete are normal remote echo,
+ not errors. `repo list` output is NOT prefixed (it is reformatted locally).
## Discovering current state