Files
Claudia-rust/README.md
matt 10d95951a3 feat: implement QoL features (toast notifications, command palette, auto-save)
Add three major quality-of-life features to improve user experience:

Toast Notification System:
- Non-blocking notifications for all major actions
- Four variants: success, error, warning, info
- Auto-dismiss with progress bar
- Bottom-right positioning with smooth animations
- Replaced old status messages throughout the app

Command Palette (Ctrl+P):
- Keyboard-driven quick access to all actions
- 14 built-in commands across 5 categories
- Real-time fuzzy search with arrow key navigation
- Shows keyboard shortcuts for each command
- Grouped by category with visual feedback

Auto-save & Recovery:
- Automatic draft saving (1s debounce)
- Per-character draft storage in localStorage
- Auto-recovery on app restart or character switch
- Draft age display (e.g., "2 hours ago")
- Auto-cleanup of drafts older than 7 days
- Clears draft when message is sent

Updated README with new Ctrl+P keyboard shortcut
Updated ROADMAP with Phase 8: Quality of Life & Polish section

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-17 12:27:20 -07:00

2.2 KiB

Claudia

Desktop AI chat application built with Tauri and Rust, focused on roleplay and character-based interactions.

Features

Chat

  • Streaming responses with real-time display
  • Full markdown rendering with syntax highlighting
  • Message swipes (multiple response alternatives)
  • Edit and regenerate from any message
  • Per-character conversation history
  • Copy code blocks with one click

Characters

  • V2/V3 character card import/export (PNG format)
  • Multiple characters with avatar support
  • Full character editor (description, personality, scenario, examples, etc.)
  • Character-specific chat history

Roleplay Tools

  • World Info/Lorebook system with keyword detection and priority
  • Author's Note with configurable positioning
  • User Personas with chat/character locking
  • Prompt Presets with instruction blocks
  • Message Examples from character cards
  • Regex Scripts for text transformations
  • Token counter with per-section breakdown

API

  • Bring-your-own-API (Anthropic-compatible)
  • Automatic model detection via /v1/models
  • API validation and error handling

Running

npm install
npm run dev

Build for production:

npm run build

Configuration

On first launch, configure in Settings:

Config stored in ~/.config/claudia/config.json

Keyboard Shortcuts

  • Enter - Send message
  • Shift+Enter - New line
  • Ctrl+Enter - Send message (alternative)
  • Up Arrow - Edit last user message (when input is at start)
  • Left/Right Arrow - Navigate between response alternatives
  • Escape - Close panels/modals, cancel editing
  • Ctrl+K - Focus message input
  • Ctrl+P - Open command palette (quick access to all actions)
  • Ctrl+/ - Toggle Roleplay Tools panel

Roadmap

See ROADMAP.md for detailed development plans.

Current Focus: Chat Branching/Checkpoints for non-linear conversation exploration

Upcoming:

  • Chat branching with timeline visualization
  • Character expression sprites
  • Group chats with multiple characters
  • Quick replies and macro system
  • Context templates for different model formats

Development

Built with:

  • Tauri 2.0
  • Rust backend
  • Vanilla JavaScript frontend
  • tiktoken-rs for token counting