Sam & Claude 4d8ce07fa7 docs: apply Prettier to current markdown (Sam & Codex)

Normalize markdown formatting after the latest main updates.\n\nChecks: python3 scripts/layered_soul.py validate .; npx --yes prettier@3 --check '**/*.md'; git diff --check.

2026-06-14 01:48:32 +02:00

1.5 KiB

Raw Blame History

Forgejo API Token Setup

Creating a token

Go to https://<forgejo-instance>/user/settings/applications
"Generate New Token"
Token name: hermes-<hostname>-agent
Select scopes:
- write:repository — create/merge PRs, push to repos
- write:organization — adjust branch protection rules (optional)
Copy the token value — it's shown only once.

Storing the token

# Append to Hermes .env (mode 0600)
echo 'FORGEJO_API_TOKEN=*** >> ~/.hermes/.env
chmod 600 ~/.hermes/.env

Using in shell

# Load from env without printing the token
source ~/.hermes/.env 2>/dev/null

# Use in curl commands
curl -s -H "Authorization: token $FORGEJO_API_TOKEN" \
  "https://<forgejo>/api/v1/user"

Pitfall: token truncation

When the token appears in a command string passed to a subshell, the Hermes agent may redact the value mid-command, resulting in truncated tokens. Always source from .env rather than pasting inline.

Minimum scopes needed

Operation	Required scope
Create PR	`write:repository`
Merge PR	`write:repository`
List PRs	`read:repository`
Adjust branch protection	`write:organization`
Create repos under org	`write:organization`
Admin (create users, manage keys)	`write:admin`

1.5 KiB Raw Blame History