npm.io
0.1.7 • Published yesterdayCLI

ryco-cli

Licence
—
Version
0.1.7
Deps
12
Size
24.5 MB
Vulns
0
Weekly
0
SummaryDependencyVersions
Ryco

Ryco

A fast local workspace for coding agents.

Codex · Claude · GitHub Copilot · OpenCode · Cursor (Early Access)

License: MIT Platforms TypeScript Bun Electron Discord

What is Ryco?

Ryco is a small, practical workspace for AI coding agents. It runs Codex, Claude, GitHub Copilot, OpenCode, and early-access Cursor side by side, with fast local workflows, clear per-provider customization, and visibility into provider behavior.

It ships as a cross-platform desktop app (macOS, Linux, Windows) and as a local web CLI backed by an Effect/TypeScript server and a React/TanStack UI.

Features

Coding agents
  • Codex — via Codex app-server, with usage windows surfaced in the UI
  • Claude — via the Claude Agent SDK, including usage windows when available
  • GitHub Copilot — via @github/copilot-sdk
  • OpenCode — via @opencode-ai/sdk or a configured OpenCode server URL
  • Cursor (Early Access) — via the Cursor Agent ACP runtime
  • Multiple named provider instances per driver (e.g. codex_personal, claude_openrouter) with independent config, environment variables, auth identity, model preferences, and accent colors
Workflow
  • Git worktree management — create and track worktrees per branch, PR, issue, or Jira work item, with status buckets (idle, in_progress, review, done)
  • Multi-terminal drawer — split terminals, custom tabs, clickable file & path links; the chat-bar toggle button reflects open/closed state
  • Composer attachments — attach GitHub, GitLab, Forgejo, Bitbucket, or Azure DevOps issues and pull/merge requests as structured turn context (# keyboard trigger). Title, body, metadata, and recent comments are forwarded to the agent
  • Diff panel with occurrence search — fast navigation inside large changes
  • Diff line click → editor — opens your configured editor at the exact file and line
  • Default editor memory — remembers your preferred editor for opening workflows
  • Symlink-aware project paths — Dropbox-on-macOS and other symlinked roots are recognized as the same workspace whether opened from /Users/you/Dropbox/... or /Users/you/Library/CloudStorage/Dropbox/...
  • Thread workspace panel — browse files, review diffs, and jump between workspace/review/terminal views without leaving the thread
UI & customization
  • Custom themes — full theme editor with live preview, import/export, and a reusable color picker component
  • Keybindings — customizable shortcuts for terminal toggle, diff toggle, new chat, script execution, and more (see KEYBINDINGS.md)
  • Command palette — searchable commands with thread and model jump bindings (Cmd+K)
  • Lexical-based prompt composer — rich editing with formatting
  • Preview panel — syntax-highlighted diffs with file-tree navigation
  • Project favicon resolver — auto-detected per-project icons in the sidebar
  • Branch toolbar — branch selector plus local/worktree environment selector integration
  • Project folders and grouped repositories — organize local and remote projects in the sidebar
Integrations & infrastructure
  • MCP server support — Model Context Protocol built in, with workspace-level configuration
  • Source-control and work-item providers — GitHub, GitLab, Forgejo/Codeberg, Azure DevOps, Bitbucket, plus Jira project/work-item workflows. See docs/source-control-providers.md
  • Remote environments — saved HTTP/WebSocket environments, pairing links/sessions, SSH utilities, and Tailscale endpoint/Serve helpers
  • Auto-updates — electron-updater with in-app update notifications in the sidebar
  • Observability — local trace files, provider event logs, and optional OTLP trace/metric export. See docs/observability.md

Install

Install and authenticate at least one provider before use:

  • Codex — install Codex CLI and run codex login
  • Claude — install Claude Code and run claude auth login
  • OpenCode — install OpenCode and run opencode auth login

GitHub Copilot and Cursor are also supported when their provider CLIs/accounts are available on the machine running Ryco. Check Settings → Providers for live auth and version status.

Run without installing
npx ryco-cli
Desktop app

Get the latest installer from GitHub Releases or use a package manager:

Platform Format Install
macOS .dmg (arm64, x64) Run Install Ryco.command from the DMG
Linux .AppImage (x64) yay -S ryco-bin (AUR)
Windows NSIS .exe (x64) Download from Releases

macOS releases are currently unsigned and not notarized because Apple requires a paid Developer ID account for notarization. If macOS says Ryco is damaged, use the Install Ryco.command helper included in the DMG or run:

xattr -dr com.apple.quarantine /Applications/Ryco.app
open /Applications/Ryco.app

Project status

Ryco is very early. Expect bugs and breaking changes. We aren't accepting contributions yet.

If you want to follow along, join the Discord or watch the repo.

Development

If you really want to dive into the code:

# Optional: only needed if you use mise for dev tool management
mise install

bun install

# Run the desktop app in dev mode
bun run dev:desktop

# Run just the web app
bun run dev:web

# Required checks before finishing changes
bun fmt
bun lint
bun typecheck

# Vitest suite
bun run test

Read CONTRIBUTING.md before opening an issue or PR.

Documentation

License

MIT Ryco Inc.