1
0
Fork
You've already forked fjo
0
Forgejo/Codeberg management CLI and MCP server
Find a file
David Wilson fa19775172 Relock against sigil 0.17.1; bump to v0.2.2 
Regenerate sigil.lock against the reintegrated monorepo. The rebuild had been silently linking stale 0.14.x pins after the package.sgl version bump (lock never regenerated).
2026年06月24日 11:26:06 +03:00
src Read mcp-server version from (app-version); bump to v0.2.1 2026年04月26日 19:39:34 +03:00
.gitignore Add .sigil/ to gitignore 2026年04月02日 08:19:23 +03:00
dev-redirects.sgl Bump deps to sigil ^0.17 / sigil-mcp 0.16.2 ecosystem 2026年06月22日 23:01:41 +03:00
package.sgl Relock against sigil 0.17.1; bump to v0.2.2 2026年06月24日 11:26:06 +03:00
README.md Migrate to transitive deps with version ranges and lockfile 2026年04月01日 13:19:45 +03:00
sigil.lock Relock against sigil 0.17.1; bump to v0.2.2 2026年06月24日 11:26:06 +03:00

fjo

A Forgejo/Codeberg management tool built with Sigil. Works as both a CLI for humans and an MCP server for AI agents.

CLI Usage

fjo repos list sigil # List repos in org
fjo repos info sigil kiln # Repo details
fjo repos create sigil new-repo "desc" # Create repo
fjo topics list sigil kiln # List topics
fjo topics set sigil kiln app ci # Set topics
fjo topics add sigil kiln library # Add topic
fjo issues list sigil kiln # List issues
fjo issues get sigil kiln 42 # Get issue details
fjo issues create sigil kiln "Bug title" # Create issue
fjo prs list sigil kiln # List pull requests
fjo prs get sigil kiln 7 # Get PR details
fjo releases list sigil sigil # List releases

MCP Server

Start with fjo serve. Exposes these tools:

  • fjo/repos-list, fjo/repos-info, fjo/repos-create
  • fjo/topics-list, fjo/topics-set, fjo/topics-add
  • fjo/issues-list, fjo/issues-get, fjo/issues-create, fjo/issues-comment
  • fjo/pulls-list, fjo/pulls-get, fjo/pulls-create, fjo/pulls-merge
  • fjo/releases-list, fjo/releases-create

Configuration

fjo reads a .env-fjo file from the working directory at startup if present. This is the standard convention for Sigil MCP servers — credentials live in a dotenv file rather than in the MCP server configuration.

Create a .env-fjo in your project root:

FORGEJO_TOKEN=your-api-token-here
FORGEJO_URL=https://codeberg.org

Environment variables set through other means (shell export, MCP config) take precedence over the dotenv file.

Variable Description Default
FORGEJO_TOKEN API token (required) —
FORGEJO_URL Instance base URL https://codeberg.org

Building

sigil deps install
sigil build

The bundled binary is at build/dev/bin/fjo.

Dependencies

License

BSD-3-Clause