claudian/agent-tools
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Shared command-line helpers for T.A.S.K.S. agent surfaces — chronicle and Forgejo access primitives
3 commits 1 branch 0 tags 53 KiB
  • Shell 100%
Find a file
Exact
Nathan Eckenrode 3931bf8ca6 License under AGPL-3.0 (house license for all projects)
2026-06-17 00:26:53 -04:00
bin Retire chronicle: drop chronicle-check/chronicle-post, keep forgejo-cli (Forgejo → Hetzner, droplet ⊮source) 2026-06-08 14:45:58 -04:00
install.sh Retire chronicle: drop chronicle-check/chronicle-post, keep forgejo-cli (Forgejo → Hetzner, droplet ⊮source) 2026-06-08 14:45:58 -04:00
LICENSE License under AGPL-3.0 (house license for all projects) 2026-06-17 00:26:53 -04:00
README.md Retire chronicle: drop chronicle-check/chronicle-post, keep forgejo-cli (Forgejo → Hetzner, droplet ⊮source) 2026-06-08 14:45:58 -04:00

README.md

agent-tools

Shared command-line helpers for the T.A.S.K.S. agent surfaces (Claudian / Hermes / Nova) — substrate-agnostic enough that any of them can use them.

chronicle retired 2026-06-08. The chronicle-check / chronicle-post helpers and the droplet-backed master_chronicle.conversations postgres are gone. The droplet is no longer source of truth for anything; Forgejo now lives on Hetzner. What remains here is the Forgejo REST wrapper.

These wrap the one thing every agent surface still needs:

  1. Forgejo REST access — HTTP Basic auth via netrc, no PAT bootstrap.

The helper is single-file bash with no external runtime dependencies beyond curl, python3, and a netrc at ~/.config/forgejo/netrc.

Contents

Path Role
bin/forgejo-cli curl wrapper around Forgejo REST API. Subcommands: whoami, issues list, issue {get,close,comment}, pr {create,list,merge}. Auth via ~/.config/forgejo/netrc.

Install (any agent surface)

git clone forgejo.claudian:claudian/agent-tools.git ~/Development/agent-tools
~/Development/agent-tools/install.sh

The installer symlinks each bin/<tool> into ~/.local/bin/<tool>, backing up any pre-existing file with a .bak.<ts> suffix. Idempotent — safe to re-run.

Prerequisites

  1. Forgejo netrc — ~/.config/forgejo/netrc mode 600, format: 
    machine <forgejo-host> login <agent-login> password <agent-password>
    The Forgejo passwords for claudian / hermes / nova are documented at ~/.config/credentials/forgejo.md (or its equivalent on each surface).
  2. $PATH — ~/.local/bin/ must be on PATH (most distros default this; Quickshell-on-Sway needs an explicit prepend, see the laptop's autostart.sh).

Why this exists (the design point)

Each surface needs to read and act on Forgejo issues and PRs. forgejo-cli is the minimum substrate-agnostic toolkit for that, with no LLM in it — smart-ness happens in the per-surface execute loops (e.g. Claudian's ralph-execute skill); this tool just makes Forgejo addressable.

Compatibility

  • Tested on EndeavorOS Arch Linux (Claudian / laptop). Should work on any Linux with bash 4+, curl, python3.

Hard rails (intentional gaps in the API surface)

  • forgejo-cli has no repo delete, no branch delete, no --force flag on pr merge — these are unsafe operations and intentionally absent.

If you find yourself needing a destructive operation here, the right path is to surface it to Nathan and let the human decide.