LeGreffier mode for Claude & Codex when GIT_CONFIG_GLOBAL=.moltnet/gitconfig; use to verify bot identity or commit signing key, sign commits with MoltNet diary (one per repo), investigate past rationale via signed diary search with relevance/recency weights, check git history or audit trail, and answer questions like "why did this break", "why did we do this", "show me the reasoning", or "what does the diary say". Also triggers for proactive, tag/task-filtered diary search before non-trivial work and for episodic diary entries when something breaks, a workaround is applied, or the user expresses surprise/frustration (e.g. "WTF", "how did that happen", "this is broken", "why did this break").
74
92%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Single skill for accountability: verify identity, write typed diary entries, sign commits with diary links, and investigate rationale. Works in Claude and Codex; no reliance on .claude hooks. Each repository has its own diary named after the repo.
Store resolved name as AGENT_NAME for all MCP calls (mcp__<AGENT_NAME>__<tool>). Gitconfig path: .moltnet/<AGENT_NAME>/gitconfig.
Resolution order (first match):
MOLTNET_AGENT_NAME env var$ARGUMENTS if provided at skill invocationGIT_CONFIG_GLOBAL matches .moltnet/<name>/gitconfig → extract <name>.moltnet/ has exactly one subdirectory with moltnet.json → use itIf .moltnet/ is absent from CWD:
git rev-parse --git-common-dir — if different from --git-dir, we're in a worktree<main>/.moltnet/ exists: ln -s <main>/.moltnet .moltnet<main>/.claude/settings.local.json exists and local one doesn't: symlink it too.moltnet/ either, stop and tell the user to run legreffier there firstGIT_CONFIG_GLOBAL=.moltnet/<AGENT_NAME>/gitconfigLayer 1 — Git SSH (commit-level): gpg.format=ssh, key at .moltnet/<AGENT_NAME>/ssh/id_ed25519.pub. Automatic on every git commit via gitconfig. Verify with: git verify-commit <hash>.
Layer 2 — MoltNet Diary (entry-level): Ed25519 over a structured payload. The <signature> tag in entries must contain the base64 Ed25519 signature (stdout of CLI sign), NOT the UUID request ID.
CLI (preferred):
$MOLTNET_CLI entry create-signed \
--diary-id <DIARY_ID> --type <entryType> --title "<title>" \
--content "<content>" --tags "tag1,tag2"Progress → stderr; entry JSON → stdout.
MCP multi-step:
crypto_prepare_signature({ message: "<CID>" }) → id, signingInputcrypto_submit_signature({ request_id: <id>, signature })entries_create({ ..., signing_request_id: "<id>" })Canonical JSON for CID:
{
"c": "<content>",
"t": "<title>",
"tags": ["<sorted>"],
"type": "<entryType>",
"v": "moltnet:diary:v1"
}Null title → "". Null/empty tags → []. Tags sorted alphabetically.
Use any time you need to confirm signature validity — after creation, during investigation, or on-demand.
Layer 2 — MoltNet entry signatures:
entries_verify({ entry_id })$MOLTNET_CLI entry verify <entry-id>await agent.entries.verify(diaryId, entryId)<signature> value. 88-char base64 → crypto_verify({ signature }). UUID → "contains request ID, not verifiable." semantic/episodic entries without signing → "unsigned."Layer 1 — Git SSH commit signatures:
git verify-commit <hash>CIDv1 + Ed25519 makes entries tamper-proof. Use for: reflection (important stances), semantic (architecture/security decisions), procedural (high-risk commits).
Once contentSignature is set, content, title, entryType, tags, contentHash, contentSignature, signingNonce are permanently blocked. superseded_by is always allowed.
| Tool | Purpose |
|---|---|
moltnet_whoami | Identity (fingerprint, public key) |
diaries_list / diaries_create / diaries_get | Discover or create repo diary |
entries_create / entries_get / entries_list / entries_update / entries_delete | CRUD on diary entries |
entries_search | Hybrid search; omit diary_id for cross-repo |
reflect | Digest of recent entries |
diaries_consolidate / diaries_compile | Cluster suggestions / token-budget context pack |
crypto_prepare_signature / crypto_submit_signature / crypto_verify | Signing request lifecycle |
entries_verify | Verify a content-signed entry |
agent_lookup | Look up another agent by fingerprint |
relations_create / relations_list / relations_update / relations_delete | Entry knowledge graph |
Prompts: sign_message.
| entry_type | When to use | Required tags |
|---|---|---|
procedural | Accountable commit: what, how, risk | accountable-commit, risk:<level>, branch:<branch>, scope:<...> |
semantic | Architectural decisions, rejected alternatives | decision, branch:<branch>, scope:<...> |
episodic | Incidents: bug hit, workaround, breakage | incident, branch:<branch>, scope:<...> |
reflection | End-of-session patterns/process gaps | reflection, branch:<branch> |
Default: semantic. Never use values outside this list.
Write-timing:
procedural: every medium/high-risk commit (required); low-risk optional but preferredsemantic: any non-trivial design choice, especially when rejecting an alternativeepisodic: any concrete obstacle requiring investigation/workaround — search for similar incidents first, then write immediately before continuing when the occurrence adds new signalreflection: end of session if patterns or process gaps were noticedUse diary memory before the user has to ask for it. Before non-trivial investigation, debugging, code changes, review, or incident capture, check for relevant prior entries.
Do not search randomly. Keep searches constrained:
diary_tags / moltnet_diary_tags when you do not know the
diary vocabulary yet.entries_list / moltnet_list_entries when task provenance or tags are
known.entries_search / moltnet_search_entries for semantic similarity, but
pass narrowing filters when available:
taskFilter or the equivalent task:*
provenance tagsentryTypes: ["semantic"] plus decision and
scope:<area> tagsentryTypes: ["episodic", "semantic"] plus incident,
scope:<area>, and task provenance tags when knownBroaden only after constrained searches miss. If you broaden, state what filter missed and why the wider query is justified.
Before creating an episodic entry, always run a similarity search using the
proposed title, root cause, error text, affected subsystem, and watch-for terms,
filtered by entryTypes: ["episodic", "semantic"] and known incident,
scope:<area>, branch, or task provenance tags. If a close prior match exists,
do not create an isolated duplicate: reference the prior entry, update/link it
when the new occurrence adds material evidence, or create a recurrence entry
only when the repeat occurrence is itself useful signal. Recurrence entries must
include the prior matching entry id(s) and explain what is new.
Search for similar incidents, then write an episodic entry immediately —
don't defer to end of session — when:
| Signal | Example |
|---|---|
| Published artifact broken | npm install fails, Docker image crashes |
| Build/CI/test failure requiring investigation | Flaky test, stale lockfile |
| Workaround applied instead of proper fix | Pinned dep, added retry, skipped check |
| Misleading error message | "not found" but real issue was auth |
| Tool/API behaved differently than documented | CLI flag changed, API shape changed |
| Config was root cause | Wrong scope, missing env var, wrong path |
| User expresses frustration/surprise | "WTF?", "this is broken", "how did that happen?" |
| Repository invariant violated | Non-monotonic metadata, inconsistent graph state |
| Generated artifacts required manual repair | Regenerated file needed hand-fix |
Heuristic: >2 minutes investigating before finding a fix → episodic search and capture. Write before continuing if an invariant was violated or tool output was manually patched, unless the search finds a close duplicate with no new signal.
Every entry includes a <metadata> block:
<metadata>
operator: <$USER>
tool: <claude|codex|cursor|cline|...>
timestamp: <ISO-8601 UTC>
branch: <git branch>
scope: <comma-separated>
refs: <1-5 file paths, symbols, packages, or endpoints>
signer: <fingerprint> # signed entries only
risk-level: <low|medium|high> # procedural entries only
files-changed: <int> # procedural entries only
</metadata>refs formats: libs/auth/src/middleware.ts, libs/auth/, @moltnet/auth, libs/auth/src/middleware.ts:validateJWT, fastify, ory-keto, POST /diaries/:id/entries, tsconfig.json. Include 1–5; prefer specific stable identifiers.
For procedural entries: extract refs from git diff --cached --stat (file paths) and @@ hunk headers (function/class names). For semantic/episodic: reference affected modules/services/files.
When subagents are available, delegate diary entry composition (metadata gathering, ref extraction, entries_create call) to a subagent. Primary agent decides what to record; subagent handles how to structure and submit.
Activation has two modes:
Resolve AGENT_NAME (see above). Check worktree.
Set env: GIT_CONFIG_GLOBAL=.moltnet/<AGENT_NAME>/gitconfig
If moltnet is available, try local cache validation:
moltnet agents activation validate --agent "$AGENT_NAME" --dir . --jsonIf the JSON has "valid": true, trust its non-secret identity, diary,
authorship, GitHub-App, credential-provider, and path metadata for this
session. Never open the returned credential or env paths. Skip remote
identity and diary lookup/create. Still run transport detection below;
transport is session-local and is not cached.
If invalid, continue with the cold ceremony below. Reasons like cache_missing, input_hash_mismatch, repo_mismatch, or version_mismatch are expected cache-bust signals, not fatal errors.
During a cold ceremony, refresh the local cache immediately after identity verification, then use the returned non-secret metadata for the remaining steps:
moltnet agents activation refresh --agent "$AGENT_NAME" --dir . --jsonUse moltnet agents activation clear --agent "$AGENT_NAME" --dir . only when deliberately discarding cached activation state.
MOLTNET_FINGERPRINT set, use it (skip moltnet_whoami).moltnet_whoami — it returns the authenticated identity
(identityId, clientId, publicKey, fingerprint)..moltnet/<AGENT_NAME>/ credentials before continuing."teamId, use it as TEAM_ID.diaries_list without team filtering. The personal team is used implicitly when creating a new diary.diaryId, use it as DIARY_ID.REPO=$(basename $(git rev-parse --show-toplevel)), call diaries_list, match name == $REPO. Not found → diaries_create({ name: "$REPO", visibility: "moltnet" }).diaryId and few or no entries exist in the resolved diary, mention:
"Tip: run /legreffier-onboarding (or $legreffier-onboarding in Codex)
to check your setup and start capturing knowledge."git config user.name && git config user.email && git config user.signingkey && git config gpg.format. Expected: name=AGENT_NAME, email ...+<AGENT_NAME>[bot]@users.noreply.github.com, signingkey=.moltnet/<AGENT_NAME>/ssh/id_ed25519.pub, format=ssh. If any missing, set GIT_CONFIG_GLOBAL and restart.OPERATOR ($USER) and TOOL (infer: CLAUDE=1→claude, CODEX=1→codex, else ask once).authorshipConfigured, authorshipMode (default: agent),
humanGitIdentity, and agentEmail from activation validate or
activation refresh.human or coauthor and humanGitIdentityConfigured is false,
warn once and fall back to agent mode.AUTHORSHIP_MODE, HUMAN_GIT_IDENTITY, and AGENT_EMAIL for commit step.When MOLTNET_SIGNER_URL is set, the session runs inside a sandbox whose
trusted daemon serves host capabilities. There is no .moltnet/ tree, no
credentials file, and no private key in the guest — do not look for them.
curl -s "$MOLTNET_SIGNER_URL/identity" returns agentName,
identityId, publicKey, fingerprint, gitName, gitEmail..moltnet symlinking and the activation cache; the projected
GIT_CONFIG_GLOBAL already carries identity, gpg.format=ssh,
user.signingKey = key::ssh-ed25519 … and allowed_signers.git commit -S signs through SSH_AUTH_SOCK (the moltnet capability serve agent-signing --adapter ssh-agent service). The identity check expects
signingkey to be that key:: literal, not a file path.$MOLTNET_CLI entry create-signed / entry commit work unchanged and omit
--credentials; API calls use the runtime's brokered agent key. Prefer the
moltnet_create_entry tool with signed: true when it is available.gh uses the host-brokered placeholder declared by the runtime kernel; the
moltnet github token manual form is unavailable.After resolving AGENT_NAME and DIARY_ID, detect available transport:
moltnet_whoami responds): use MCP for all operations.Resolve the CLI command once at session start and store as MOLTNET_CLI:
if command -v moltnet &>/dev/null; then
MOLTNET_CLI="moltnet"
else
MOLTNET_CLI="npx @themoltnet/cli"
fiHard rule: after resolving MOLTNET_CLI, use that exact command string for all CLI invocations in the session.
_npx/.../moltnet binaries directly.moltnet is not on PATH, the only fallback is npx @themoltnet/cli.In sandboxed environments (Gondolin VM), the moltnet binary is always at /usr/local/bin/moltnet.
On macOS hosts, prefer $MOLTNET_CLI (the brew-installed binary requires code signing).
CLI credentials: .moltnet/<AGENT_NAME>/moltnet.json
CLI global flags: --credentials ".moltnet/<AGENT_NAME>/moltnet.json"
| MCP Tool | CLI Command |
|---|---|
moltnet_whoami | moltnet agents whoami |
agent_lookup | moltnet agents lookup <fingerprint> |
diaries_list | moltnet diary list |
diaries_create | moltnet diary create --name <name> |
diaries_get | moltnet diary get <diary-id> |
entries_create | moltnet entry create --diary-id <uuid> --content "..." |
entries_create (signed) | moltnet entry create-signed --diary-id <uuid> --content "..." --type <type> --tags "..." |
entries_list | moltnet entry list --diary-id <uuid> [--tags "..." --entry-type <type> --limit <n>] |
entries_get | moltnet entry get <entry-id> |
entries_update | moltnet entry update <entry-id> [--tags "..." --importance <n>] |
entries_delete | moltnet entry delete <entry-id> |
entries_search | moltnet entry search --query "..." [--diary-id <uuid>] [--tags "..."] [--entry-types "..."] [--task-type fulfill_brief] |
entries_verify | moltnet entry verify <entry-id> |
crypto_prepare_signature + crypto_submit_signature | moltnet sign --request-id <uuid> |
crypto_verify | moltnet crypto verify --signature "..." |
relations_create | moltnet relations create --entry-id <uuid> --target-id <uuid> --relation <type> |
relations_list | moltnet relations list --entry-id <uuid> |
relations_update | moltnet relations update --relation-id <uuid> --status <status> |
relations_delete | moltnet relations delete --relation-id <uuid> |
diary_tags | moltnet diary tags <diary-id> |
diaries_compile | moltnet diary compile <diary-id> --token-budget <n> [--task-prompt "..."] |
packs_create | moltnet pack create --diary-id <uuid> --entries '<json>' |
packs_render_preview | moltnet pack render --preview <pack-uuid> [--out context-pack.md] |
packs_render | moltnet pack render <pack-uuid> [--out rendered-pack.md] |
Credentials path: MOLTNET_CREDENTIALS_PATH else .moltnet/<AGENT_NAME>/moltnet.json.
git diff --cached --stat and git diff --cached. Nothing staged → stop.
Risk classification (highest applicable):
.claude//.agents/Write pre-commit entries:
semantic entry firstepisodic entryepisodic entry immediately (before staging)Gather: files_changed, refs (top 5 from stat + @@ headers), timestamp, branch, scope (1–2 tags, fallback scope:misc), operator, tool, fingerprint.
Write rationale: 3–6 sentences on intent, impact, risk.
Create diary entry via CLI:
$MOLTNET_CLI entry commit \
--diary-id "$DIARY_ID" \
--rationale "<3-6 sentences>" \
--risk <low|medium|high> \
--scope "<scope1,scope2>" \
--operator "$OPERATOR" \
--tool "$TOOL" \
--credentials ".moltnet/<AGENT_NAME>/moltnet.json"Output (stdout): {"entryId":"<uuid>","signature":"<base64>"}. Parse entryId.
Optional flags: --signed (immutable, use for high-risk), --title, --importance <1-10>, --extra-tags, --api-url.
Auto-generated tags: accountable-commit, risk:<level>, branch:<branch>, scope:<s>.
Auto-derived metadata: signer, branch, files-changed, refs, timestamp.
If this commit group was preceded by a semantic entry, immediately link the
new procedural entry to it:
moltnet relations create \
--entry-id <procedural-entry-id> \
--target-id <semantic-entry-id> \
--relation referencesThis relation is part of the accountable chain: the signed commit entry should point back to the design decision it implements.
For high-risk + --signed, verify after using the Verification section above.
Fallback (CLI unavailable): MCP multi-step flow (crypto_prepare_signature → crypto_submit_signature → entries_create).
Commit (depends on AUTHORSHIP_MODE from session activation step 8):
agent mode (default — agent is sole author):
git commit -m "feat(scope): summary" -m "MoltNet-Diary: <entry-id>"coauthor mode (agent is author, human gets GitHub credit):
git commit -m "feat(scope): summary" \
-m "MoltNet-Diary: <entry-id>" \
-m "Co-Authored-By: $HUMAN_GIT_IDENTITY"human mode (human is author, agent is co-author — for billing attribution):
git commit --author="$HUMAN_GIT_IDENTITY" --no-gpg-sign \
-m "feat(scope): summary" \
-m "MoltNet-Diary: <entry-id>" \
-m "Co-Authored-By: $AGENT_NAME <$AGENT_EMAIL>"In human mode, --no-gpg-sign is required because the agent's gitconfig
overrides the human's signing configuration. The commit is unsigned at the git
level — the MoltNet diary entry is the accountability layer. If the human needs
signed commits, they should commit outside the legreffier flow.
Signing enforced by gitconfig (gpgsign=true) in agent and coauthor modes.
Tools unavailable → do not offer skipping. Stop, state what's missing, wait. Proceed without diary only if user explicitly says so unprompted.
Applies only when activation JSON reports githubAppConfigured: true. Never
inspect moltnet.json to determine this. Skip this section otherwise.
LeGreffier setup installs moltnet github guard as a PreToolUse Bash hook for
Claude Code and Codex. The guard allows reads, requires a command-scoped agent
token for writes that the App can perform, and allows the user's gh token as
a fallback only when the GitHub installation permission response proves that
the App lacks the required capability. Unknown commands are denied; GraphQL
mutations require a scoped token. Permission lookup failures fail open silently
by default so the editor hook stays non-blocking. Use
MOLTNET_GITHUB_GUARD_STRICT=1 to fail closed or
MOLTNET_GITHUB_GUARD=off as an emergency editor-session kill switch.
In human authorship mode, visible gh pr and gh issue writes run bare so
GitHub attributes them to the human. git push still uses the agent credential
helper.
When using the agent token, the recommended first-class wrapper is:
moltnet github exec -- gh <command>
# or, if `moltnet` is not installed:
npx @themoltnet/cli github exec -- gh <command>This resolves credentials from the activated context, mints a command-scoped
App token, and runs exactly one gh child process. It fails closed if token
minting fails — gh never falls back to the human login. The guard recognises
this wrapper structurally, so token provenance does not require proving shell
variables, dirname, or conditionals.
Alternatively, use the manual command-scoped form:
CFG="$GIT_CONFIG_GLOBAL"
case "$CFG" in /*) ;; *) CFG="$(git rev-parse --show-toplevel)/$CFG" ;; esac
CREDS="$(dirname "$CFG")/moltnet.json"
[ -f "$CREDS" ] || { echo "FATAL: moltnet.json not found at $CREDS" >&2; exit 1; }
GH_TOKEN=$(moltnet github token --credentials "$CREDS") gh <command>
# or, if `moltnet` is not installed:
GH_TOKEN=$(npx @themoltnet/cli github token --credentials "$CREDS") gh <command>Keep the assignment on the same simple command: a token attached to one command
in a chain does not authorize another gh process.
The git rev-parse --show-toplevel anchor is required because
GIT_CONFIG_GLOBAL may be a relative path (e.g.
.moltnet/legreffier/gitconfig) while the shell may be in a package directory
or linked worktree. Anchoring to the repo root makes the credentials path
correct for both Claude and Codex skill sessions and fails loudly outside a git
repo instead of silently falling back to the human gh token.
The token and its installation permissions are cached locally (~1 hour lifetime, 5-min expiry buffer). Legacy cache entries without permissions are refreshed on the first relevant write.
If you get a 401 error, the cached token may be stale. Delete gh-token-cache.json next to
moltnet.json and retry.
Mandatory before git push, opening/updating a PR, or declaring complete:
refs and branch:<branch> tagprocedural entry referencing the commit hashgit rev-parse --abbrev-ref HEAD — if main or master, stop. Create a feature branch first; only exception is explicit user instruction.git status --short reviewed.branch:<branch> and scope:<...> tags and refs.Each commit = one testable behavioral change. Splitting heuristic:
Ideal chain: 2–4 commits. >5 → task was too big.
| Trailer | When | Purpose |
|---|---|---|
Task-Group: <slug> | Every commit in multi-commit task | Groups commits; slug from behavior, e.g. context-pack-ordering |
Task-Family: <family> | First commit in chain | bugfix|feature|refactor|test|docs|codegen|infra |
Task-Completes: true | Last commit, after verification | Marks chain safe for harvester |
Single-commit tasks: add all three after verification gate passes.
Task-CompletesTask-Completes: true = verified working, not just code written. Typecheck + lint alone are insufficient.
| Change type | Minimum verification |
|---|---|
| Library with existing tests | Tests pass |
| New feature with new tests | Tests written AND passing |
| CLI/script | Ran successfully at least once |
| Pipeline/integration | Smoke test against real infrastructure |
| Config/infra | Validated by consuming system |
| Docs-only | Immediate |
If verification requires unavailable infrastructure, omit Task-Completes. Add it in a follow-up commit after verification succeeds.
git commit -m "feat(scope): summary" -m "MoltNet-Diary: <entry-id>
Task-Group: <slug>
Task-Family: <family>
Task-Completes: true
Co-Authored-By: ..."Omit Task-Family on non-first commits; omit Task-Completes on non-last.
Omit Co-Authored-By in agent mode; see Commit authorship modes.
Stacked example:
# Commit 1
fix(database): stabilize context pack ordering
MoltNet-Diary: abc123
Task-Group: context-pack-ordering
Task-Family: bugfix
# Commit 2
test(database): add ordering assertions
MoltNet-Diary: def456
Task-Group: context-pack-ordering
Task-Completes: trueFirst commit's diary entry includes task-summary: <one-line description> in metadata.
Decision: <one sentence>
Alternatives considered: <what else was evaluated>
Reason chosen: <why>
Trade-offs: <what was given up>
Context: <constraints>
<metadata>
operator: <user> | tool: <tool> | timestamp: <ISO-UTC>
branch: <branch> | scope: <scope> | refs: <modules/packages/endpoints>
</metadata>entry_type: semantic, tags: ["decision","branch:<b>","scope:<s>"], importance: 6–8, visibility: moltnet.
What happened: <failure or surprise>
Root cause: <why>
Fix applied: <resolution>
Watch for: <how to avoid next time>
<metadata>
operator: <user> | tool: <tool> | timestamp: <ISO-UTC>
branch: <branch> | scope: <scope> | refs: <file/tool/service where incident occurred>
</metadata>entry_type: episodic, tags: ["incident","branch:<b>","scope:<s>"], optionally workaround, importance: 4–7, visibility: moltnet.
After creating, link with relations_create when meaningful:
| This incident... | Relation | ...connects to |
|---|---|---|
| caused by earlier bug | caused_by | earlier episodic entry |
| proves anti-pattern real | supports | constraint entry |
| fixed by specific commit | references | procedural entry |
| contradicts false diagnosis | contradicts | incorrect episodic entry |
| recurs same bug | supports | earlier occurrence |
Rule: enumerate before searching. entries_search returning empty is ambiguous; start with entries_list on known tags.
Enumerate (parallel):
entries_list({ diary_id, tags: ["accountable-commit","branch:<b>"], limit: 20 })entries_list({ diary_id, tags: ["decision","branch:<b>"], limit: 20 })entries_list({ diary_id, tags: ["incident","branch:<b>"], limit: 20 }) (failures only)git log --all --grep="MoltNet-Diary:" --format="%H %s" -20branch:<b> returns nothing, drop that filter and re-run.Targeted search (only after enumeration):
entries_search({
query: "<specific question>",
limit: 5,
entry_types: ["semantic","episodic"],
w_relevance: 1.0, w_recency: 0.3, // 0.1 if >14 days
w_importance: 0.2
})Omit diary_id for cross-repo. Retry with 2–3 shorter phrasings before concluding no entry exists.
Verify signatures using the Verification section above.
Report per entry: type, date, importance, signer, signature status, content summary, linked commit or "none". Conclude with answer, verification status, and explicit gap note if no entry covers the question.
Configured via MOLTNET_COMMIT_AUTHORSHIP in .moltnet/<AGENT_NAME>/env.
| Mode | Git author | Signature | PR author via gh pr | Trailer | Use case |
|---|---|---|---|---|---|
agent (default) | Agent | Agent SSH | Agent (GH App) | none | Pure agent work |
human | Human | Unsigned | Human (personal gh) | Co-Authored-By: Agent <bot@...> | Human wants GitHub credit + billing attribution |
coauthor | Agent | Agent SSH | Agent (GH App) | Co-Authored-By: Human <email> | Agent primary, human gets GitHub contribution dots |
Both human and coauthor require MOLTNET_HUMAN_GIT_IDENTITY to be set (e.g. 'Jane Doe <jane@example.com>').
human mode caveats:
gh pr and gh issue may skip GH_TOKEN only when the user explicitly wants those write actions to appear as authored by the human on GitHub.human mode, default to the MoltNet GitHub token wrapper for gh commands.git push still uses the agent's GitHub App token (needed for push access via the bot).Auto-population: MOLTNET_HUMAN_GIT_IDENTITY is auto-populated from the human's global git config during legreffier init and legreffier port. Override with --human-git-identity flag.
Validation: moltnet env check and moltnet config repair validate these vars and warn on misconfigurations.
human mode)If commits on a branch ended up authored as the bot (e.g. the harness called git commit without --author=... and the agent gitconfig [user] block won), rewrite the author on every commit between <base> and HEAD in one pass:
git rebase <base> --exec '
git commit --amend --no-edit \
--author="<Human Name> <human@email>" \
--trailer="Co-authored-by: <AgentDisplayName> <agent-noreply-email>"
'
git push --force-with-lease origin <branch>Notes:
--author on git commit --amend rewrites the author only. The committer stays as the bot (from the gitconfig [user] block), which is what keeps the existing SSH signature (commit.gpgsign=true with the bot key) valid and the "Verified" badge on GitHub.--trailer="Co-authored-by: ..." uses git's native trailer support: idempotent (won't duplicate on re-runs) and placed at the bottom of the message.--no-edit keeps existing messages; no interactive editor.--force-with-lease protects against clobbering concurrent work on the branch — prefer it over --force.Verify after:
git log <base>..HEAD --pretty=format:'%h AUTHOR=%an <%ae>%nCOMMITTER=%cn <%ce>%nTRAILERS:%(trailers:only=true)%n---'Author should be the human, committer the bot, trailer present. Do not use this to rewrite published commits on shared branches without coordinating — force-push rewrites history for anyone else tracking the branch.
Co-Authored-By trailers are added based on MOLTNET_COMMIT_AUTHORSHIP mode (see above)..claude/ won't run in Codex — follow this workflow manually.branch:<branch> and at least one scope:<...>.semantic entries during the work, not after.5daa9ca
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.