gyokuro

Features in detail

Six things gyokuro does well — explained properly instead of in one line.

Issues & pull requests

Create, comment, label, merge — the complete workflow, no laptop required.

Tap titles, descriptions and details to change them in place — no separate edit mode. Create labels on the go, adjust milestones and assignees in the same pass. Swipe gestures close, reopen or assign issues without opening the detail view.

Pull requests give you full control: change the base branch, milestone and reviewers, submit reviews, attach comments to individual lines in the diff, and update the branch with a single tap. The mergeable status sits prominently at the top, and the iPad shows diffs side by side.

Comments can be edited, deleted and given emoji reactions; the activity timeline shows what happened over an issue’s life. Several issues can be merged into one — attachments included — or copied into multiple repositories in one go.

Actions & runners

Follow workflow runs, read logs, restart failed runs right from your phone.

See running and past workflow runs with status and duration. Logs arrive coloured and live, so you can watch a build instead of guessing afterwards. Restart failed runs directly, trigger workflows manually, and cancel runs in progress.

You can manage the runners themselves from the app too: register new ones, pause existing ones or remove them. If your CI lives in the homelab, you no longer need to walk to a computer for that.

This requires Actions to be enabled on the server and in the respective repository — if it isn’t, the section simply stays empty.

Read & edit code

Full-text code search across repositories, edit files and commit right away.

Code search looks through source code across all your repositories — handy when you’re out and just need to know where a function actually comes from.

Files can be edited right in the app: with syntax highlighting, automatic indentation and a direct commit. Creating and deleting files is included. Markdown renders the way it’s meant to — READMEs, alert callouts, checkable task lists and code with highlighting.

Releases aren’t just viewable: create and edit them, upload file assets or remove them again.

Notifications

Push through your own ntfy or Gotify server — self-hosted all the way.

For push messages gyokuro uses your own ntfy or Gotify instance. There’s no detour via a third-party service — the notification takes the same route as the rest of your infrastructure.

Filter what reaches you per repository and per type. Mentions from your main project arrive instantly while an archived repository stays silent. An app badge shows the number of unread notifications.

There are also local notifications that need no server at all, plus an optional weekly report: the last seven days with activities, issues, pull requests, lines of code and your most active repositories.

Built for the homelab

Any number of servers — with self-signed certificates, proxies or internal addresses.

gyokuro assumes your server isn’t sitting in a data centre with a perfect certificate. Self-signed certificates are safely pinned rather than blindly trusted, and there’s support for mTLS, HTTP and SOCKS proxies, custom HTTP headers and Basic Auth.

Add as many Gitea and Forgejo instances as you like and switch between them. Servers that only allow authenticated API access work as well.

If signing in still fails, the live login log helps: it records every step of the check, so you see immediately whether it’s the address, the certificate or the token.

Your data stays yours

Direct connection to your server. No cloud, no tracking, no accounts.

gyokuro talks exclusively to the servers you enter yourself. There is no intermediary service, no user account and no registration.

Access tokens live exclusively in the iOS Keychain on your device. Since version 2.3, gyokuro additionally makes sure a token isn’t sent to third-party hosts by mistake — for instance when a repository references external content.

No analytics, tracking or advertising services are built in, and crash reports don’t go to third parties.

← gyokuro