claude-app/README.md
Ole-Morten Duesund 101c91c4d8 Rename to claudify, add docs and .deb packaging
- 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>
2026-02-16 13:31:33 +01:00

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