- Rename package from claude-app to claudify (v0.1.0) - Add README.md with install/usage instructions - Add CLAUDE.md with architecture, build, and known issues - Add .desktop file for application menu integration - Build target set to .deb only - Remove failed CSD button workarounds, document upstream bug - Remove gtk dependency (no longer needed) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
56 lines
2 KiB
Markdown
56 lines
2 KiB
Markdown
# 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
|