claude-app/README.md

56 lines
2 KiB
Markdown
Raw Normal View History

# Claudify
A native Linux desktop app for [claude.ai](https://claude.ai). Not a browser — a dedicated app that lives in your system tray, persists login sessions, and forwards notifications natively.
Built with [Tauri v2](https://v2.tauri.app/) and WebKitGTK.
## Features
- **System tray** — hide/show from tray icon, left-click toggles visibility
- **Session persistence** — cookies and localStorage persist across restarts
- **Native notifications** — browser Notification API bridged to desktop notifications
- **Navigation guard** — only claude.ai, Anthropic, and OAuth provider domains load in-app; all other links open in your default browser
- **Lightweight** — uses system WebKitGTK, no bundled browser engine (~5MB .deb)
## Install
### From .deb
```bash
sudo dpkg -i claudify_0.1.0_amd64.deb
```
Requires `libwebkit2gtk-4.1-0` and `libayatana-appindicator3-1` (pulled automatically via `apt`).
### From source
```bash
# Install system dependencies
sudo apt install libwebkit2gtk-4.1-dev libxdo-dev librsvg2-dev libayatana-appindicator3-dev
# Install Tauri CLI
cargo install tauri-cli --version "^2.0" --locked
# Build
cargo tauri build
```
The .deb will be at `src-tauri/target/release/bundle/deb/claudify_0.1.0_amd64.deb`.
## Usage
Launch `claudify` from your application menu or terminal.
- **Close button** hides the window to the system tray (app keeps running)
- **Tray icon left-click** toggles window visibility
- **Tray icon right-click** shows menu: Hide/Show Claude, Quit
- **Ctrl+Plus/Minus** zooms in/out
- **External links** open in your default browser
## Known Issues
- Window titlebar buttons (minimize/maximize/close) become non-interactive after hiding and restoring the window from the system tray. This is an [upstream bug](https://github.com/tauri-apps/tauri/issues/11856) in Tauri's GTK client-side decoration handling ([tao#1046](https://github.com/tauri-apps/tao/issues/1046)). Use the tray icon to hide/show and quit.
## License
MIT