A read-only GitHub companion for Android.
Your repos, your contributions, your activity, presented clearly without the noise of the full GitHub mobile experience.
GitHub's mobile app is built for work. Shikai is built for you.
Shikai gives you a clean, read-only view of your GitHub world. No write operations. No accidental merges on a tiny screen. Just your work, at a glance.
 Pinned repos, contribution graph with streaks, and a live activity feed |
 Browse repos with filters, file trees, syntax highlighting, and health badges |
 Global search across repos, users, and issues with fuzzy matching |
 Your GitHub card with stats, social links, notifications, and saved repos |
Take a look at Shikai before you install: View Screenshots on Google Drive
| Feature | Description |
|---|---|
| Overview Dashboard | Pinned repos, contribution graph with streaks, live activity feed, and following preview |
| Repository Browser | File trees, syntax highlighting, commit history, issues, PRs, and branch selector |
| Global Search | Fuzzy search across repos, users, and issues with debounced input and eager pagination |
| User Profiles | View any GitHub user's profile with avatar, bio, stats, and top repositories |
| Android Widget | Home screen widget showing contribution streak with longest streak and recent activity |
Optional PAT support unlocks features beyond the GitHub App token:
| Feature | Required Scopes |
|---|---|
| Notifications | notifications |
| Following Feed | notifications, repo |
Tokens are validated, stored securely in expo-secure-store, and used only for direct GitHub API calls.
Choose from 5 palettes, each with unique contribution graph colors:
| Light | Dark | Tokyo Night | Dracula | Atom One Dark |
|---|---|---|---|---|
| Clean and bright | Easy on the eyes | Neon-inspired | Rich purples | Warm and muted |
Pick your favorite from Profile > Settings > Theme. Selection persists across app restarts.
Network state detection with MMKV-backed disk persistence. The app works offline with cached data and shows a banner when you're disconnected. Ephemeral queries are excluded from disk cache.
- OTA Updates - Silent over-the-air updates via expo-updates. App checks and applies updates transparently on launch.
- File Viewer - SVG and PDF rendering alongside markdown files. Syntax-highlighted code blocks with copy buttons.
- Keyboard Shortcuts - Cmd/Ctrl + 1-4 for tabs, Cmd/Ctrl + F for search, arrow keys for navigation
- Version Check - Dismissible update banner when a new release is available
- Error Recovery - ErrorBoundary wrapping root and tabs layouts with a custom 404 screen
- Saved Repos - Bookmark any repo. Stars and Watchlist combined in one screen with search and filter
- Markdown Preview - README and markdown files rendered inline with syntax-highlighted code blocks
- Open Shikai and tap Sign in with GitHub
- Authorize the app (read-only permissions only)
- Your dashboard loads instantly
- Optionally, add a PAT in Profile > Settings > Notifications & Following for notifications and activity feed
| Shortcut | Action |
|---|---|
| Cmd/Ctrl + 1-4 | Switch between tabs |
| Cmd/Ctrl + F | Focus search bar |
| Arrow Up/Down | Navigate lists |
| Escape | Dismiss search |
Shikai takes security seriously:
- Read-only access - Cannot modify, create, or delete anything on your GitHub account
- Secure token exchange - OAuth tokens are exchanged via a Cloudflare Worker proxy and never leave your device
- On-device encryption - Tokens stored with
expo-secure-store(Keychain/Keystore) - Root/debugger detection - Blocks usage on compromised environments
- No data transmission - PATs are used only for direct GitHub API calls, never sent elsewhere
- Cache hygiene - MMKV cache cleared on sign-in and sign-out
Developer mode is blocked by default on release builds. Developers can override this after accepting a risk warning.
Want early access to new features?
- Join the Beta - Sign up for early access
- Share Feedback - Lemme know what you think
| Layer | Technologies |
|---|---|
| Framework | React Native, Expo, TypeScript |
| State | React Query, Zustand, MMKV |
| UI | Reanimated, FlashList |
| APIs | GitHub REST & GraphQL, GitHub OAuth (PKCE) |
| Updates | expo-updates (OTA), EAS Build |
| Infra | Cloudflare Workers |
Contributions are welcome. Please open an issue first to discuss what you'd like to change.
MIT
Built by Atharv Dange