Clivyn

English · Türkçe

---

English

Cross-platform AI prompt improver: macOS menu bar, Linux/Windows system tray, shared Rust worker.

Features (v0.1)

• macOS: Menu bar, clipboard-based improvement, global shortcut (⌥⌘C)
• Linux / Windows: System tray (Rust), clipboard-based improvement
• Multi-provider: Gemini, OpenAI, Anthropic, OpenRouter
• Local agents: Codex CLI, Claude Code, Cursor Agent
• Streaming: SSE chunked responses
• Remote updates: Manifest check; user downloads or snoozes
• Distribution: Homebrew, Winget, Scoop templates
• i18n: EN / TR

Requirements

Platform	Tools
All	Rust (Cargo)
macOS	Xcode / Swift 5.9+, macOS 14+

Install (macOS)

git clone https://github.com/0furkancolak/clivyn.git
cd clivyn
cargo xtask build --platform macos
cargo xtask install

On first launch, set a provider API key from the menu.

Homebrew:

brew tap 0furkancolak/clivyn https://github.com/0furkancolak/clivyn
brew install --cask clivyn

Linux / Windows:

# Linux (on Linux host)
cargo xtask package --platform linux    # → .build/releases/clivyn-linux-amd64.tar.gz

# Windows (on Windows host)
cargo xtask package --platform windows  # → .build/releases/clivyn-windows-amd64.zip

Extract and run the tray binary; keep clivyn-worker in the same folder. See docs/releasing.md.

Development

cp .env.example .env   # optional, for worker dev
cargo run -p clivyn-worker

Verify:

cargo xtask lint
cargo xtask test

See docs/architecture.md · CONTRIBUTING.md

Local agent command overrides:

export CLIVYN_AGENT_CODEX_COMMAND='codex exec "$CLIVYN_AGENT_PROMPT"'
export CLIVYN_AGENT_CLAUDE_COMMAND='claude -p "$CLIVYN_AGENT_PROMPT"'
export CLIVYN_AGENT_CURSOR_COMMAND='cursor-agent --print --mode ask --trust "$CLIVYN_AGENT_PROMPT"'

Repository layout

apps/macos/              → Swift menu bar
crates/clivyn-shared/   → types, i18n, updates manifest
crates/clivyn-worker/   → Rust worker
crates/clivyn-desktop/  → Linux/Windows tray
xtask/                   → build, install, package
.build/                  → macOS .app output
.dist/                   → worker + desktop binaries
releases/manifest.json
distributions/           → winget, scoop
Casks/clivyn.rb

Updates

The app periodically fetches releases/manifest.json. When a newer version exists, the menu shows Download or Remind Later.

License

MIT

---

Türkçe

Çok platformlu AI prompt geliştirici: macOS menu bar, Linux/Windows system tray, paylaşılan Rust worker.

Özellikler (v0.1)

• macOS: Menu bar, clipboard tabanlı geliştirme, global kısayol (⌥⌘C)
• Linux / Windows: System tray (Rust), clipboard tabanlı geliştirme
• Çoklu sağlayıcı: Gemini, OpenAI, Anthropic, OpenRouter
• Yerel agent: Codex CLI, Claude Code, Cursor Agent
• Streaming: SSE ile parça parça yanıt
• Uzaktan güncelleme: Manifest kontrolü; kullanıcı indirir veya erteler
• Dağıtım: Homebrew, Winget, Scoop şablonları
• i18n: TR / EN

Gereksinimler

Platform	Araçlar
Tümü	Rust (Cargo)
macOS	Xcode / Swift 5.9+, macOS 14+

Kurulum (macOS)

git clone https://github.com/0furkancolak/clivyn.git
cd clivyn
cargo xtask build --platform macos
cargo xtask install

İlk çalıştırmada menüden seçili sağlayıcı için API anahtarı gerekir.

Homebrew:

brew tap 0furkancolak/clivyn https://github.com/0furkancolak/clivyn
brew install --cask clivyn

Linux / Windows:

cargo xtask package --platform linux    # Linux → .build/releases/clivyn-linux-amd64.tar.gz
cargo xtask package --platform windows  # Windows → .build/releases/clivyn-windows-amd64.zip

Arşivi açın; tray binary ile clivyn-worker aynı klasörde olmalı. Ayrıntı: docs/releasing.md.

Geliştirme

cp .env.example .env   # worker dev için (opsiyonel)
cargo run -p clivyn-worker

Doğrulama:

cargo xtask lint
cargo xtask test

Detaylar: docs/architecture.md · CONTRIBUTING.md

Repo yapısı

apps/macos/              → Swift menu bar
crates/clivyn-shared/   → types, i18n, updates manifest
crates/clivyn-worker/   → Rust worker
crates/clivyn-desktop/  → Linux/Windows tray
xtask/                   → build, install, package
.build/                  → macOS .app çıktısı
.dist/                   → worker + desktop binary
releases/manifest.json
distributions/           → winget, scoop
Casks/clivyn.rb

Güncellemeler

Uygulama releases/manifest.json dosyasını periyodik kontrol eder. Yeni sürüm varsa menüde İndir veya Daha Sonra Hatırlat seçenekleri sunulur.

Lisans

MIT