Commit6337b626Recorded20 Mar 2026Repositoryfjo

Add README and .gitignore

Changed
 .gitignore |  1 +
 README.md  | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+)
Diff
.gitignoreadded
@@ -0,0 +1 @@
+1
build/
README.mdadded
@@ -0,0 +1,53 @@
+1
# fjo
+2
+3
A Forgejo/Codeberg management tool built with [Sigil](https://codeberg.org/sigil/sigil). Works as both a CLI for humans and an MCP server for AI agents.
+4
+5
## CLI Usage
+6
+7
```
+8
fjo repos list sigil # List repos in org
+9
fjo repos info sigil kiln # Repo details
+10
fjo repos create sigil new-repo "desc" # Create repo
+11
fjo topics list sigil kiln # List topics
+12
fjo topics set sigil kiln app ci # Set topics
+13
fjo topics add sigil kiln library # Add topic
+14
fjo issues list sigil kiln # List issues
+15
fjo issues get sigil kiln 42 # Get issue details
+16
fjo issues create sigil kiln "Bug title" # Create issue
+17
fjo prs list sigil kiln # List pull requests
+18
fjo prs get sigil kiln 7 # Get PR details
+19
fjo releases list sigil sigil # List releases
+20
```
+21
+22
## MCP Server
+23
+24
Start with `fjo serve`. Exposes these tools:
+25
+26
- `fjo/repos-list`, `fjo/repos-info`, `fjo/repos-create`
+27
- `fjo/topics-list`, `fjo/topics-set`, `fjo/topics-add`
+28
- `fjo/issues-list`, `fjo/issues-get`, `fjo/issues-create`, `fjo/issues-comment`
+29
- `fjo/pulls-list`, `fjo/pulls-get`, `fjo/pulls-create`, `fjo/pulls-merge`
+30
- `fjo/releases-list`, `fjo/releases-create`
+31
+32
## Configuration
+33
+34
| Variable | Description | Default |
+35
|----------|-------------|---------|
+36
| `FORGEJO_TOKEN` | API token (required) | — |
+37
| `FORGEJO_URL` | Instance base URL | `https://codeberg.org` |
+38
+39
## Building
+40
+41
```bash
+42
sigil build --redirects dev-redirects.sgl
+43
```
+44
+45
The bundled binary is at `build/dev/bin/fjo`.
+46
+47
## Dependencies
+48
+49
- [sigil-forgejo](https://codeberg.org/sigil/sigil-forgejo) — Forgejo API client library
+50
+51
## License
+52
+53
BSD-3-Clause