Obelica Tools

Scopo

obelica-tools e' il repository per tooling locale Obelica.

Contiene:

un CLI Rust chiamato obelica per macOS, che automatizza tunnel SSH verso servizi privati del server;
obelica-backup, il tool server in Rust per backup automatico.

Il CLI locale e' pensato per rendere Forgejo un'esperienza simile a GitHub, ma privata: si apre un tunnel e poi si usano git pull, git push, Cursor, VS Code e gli autodeploy Forgejo come in un normale flusso Git.

Repository

bona/obelica-tools

Checkout server:

/opt/obelica/repos/obelica-tools

obelica CLI

Sicurezza

Il CLI usa il comando di sistema ssh, quindi riusa:

~/.ssh/config;
SSH agent;
known_hosts;
keychain macOS;
alias obelica-prod.

Non salva IP, username, chiavi, password o token.

Comandi

obelica services
obelica tunnel forgejo
obelica tunnel docs
obelica tunnel traefik
obelica tunnel all
obelica tunnel all --open
obelica open docs
obelica config path
obelica config print-default

Servizi default

Service	URL locale	Remote
`forgejo`	`http://127.0.0.1:3333`	`127.0.0.1:3333`
`docs`	`http://127.0.0.1:3334`	`127.0.0.1:3334`
`traefik`	`http://127.0.0.1:8080/dashboard/`	`127.0.0.1:8080`

Installazione Mac

Finche' Forgejo resta privato:

ssh -L 3333:127.0.0.1:3333 obelica-prod

Poi:

git clone http://127.0.0.1:3333/bona/obelica-tools.git
cd obelica-tools
cargo install --path .
obelica services
obelica tunnel all

Aggiornare il tool dopo modifiche al repo:

cd /path/to/obelica-tools
git pull
cargo install --path .

Workflow Forgejo privato

Aprire il tunnel:

obelica tunnel all

Usare Git normalmente nei repository che hanno remote Forgejo su http://127.0.0.1:3333/...:

git pull
git push

Lasciare aperto il processo del tunnel mentre si lavora con Cursor/VS Code.
Chiudere il tunnel con Ctrl-C quando non serve piu'.

Se un fetch fallisce con Failed to connect to 127.0.0.1 port 3333, il tunnel non e' attivo oppure Git sta girando in un contesto diverso da quello locale.

obelica-backup

Vedi pagina dedicata obelica-backup.

Stato repository

Stato 2026-06-23: il flusso atteso e' usare obelica tunnel all prima di operare sui remote Forgejo privati. Non esporre Forgejo pubblicamente finche' non sono completati hardening, backup offsite e policy utenti.

Evoluzione possibile

obelica server doctor;
obelica deploy obelica-docs;
obelica backup status;
obelica forgejo open;
TUI con lista servizi e tunnel.

Obelica Tools

On this page