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

sigil deps install
sigil build