shura/valdis
1
0
Fork 0
mirror of https://github.com/valdis-app/valdis.git synced 2026-05-14 23:02:59 +02:00
Code Issues Projects Releases Packages Wiki Activity
No description
13 commits 1 branch 20 tags 1.4 MiB
Find a file
Exact
Valdis 1afe73bc95 docs: update list of AI tools with new addition
2026-02-14 17:45:57 +03:00
images feat: Add detailed issue reporting instructions and screenshots 2026-01-20 04:23:27 +03:00
README.md docs: update list of AI tools with new addition 2026-02-14 17:45:57 +03:00

README.md

Valdis — Issue Tracker

This repository is only for bug reports and feature requests for Valdis. Valdis is closed-source — no code lives here.

Supported OS: macOS 15+ and iOS/iPadOS 18+.

Quick links

How to open an issue

  1. Sign in to GitHub.
  2. Open the new issue chooser: https://github.com/valdis-app/valdis/issues/new/choose
  3. Pick Bug report or Feature request, fill out the template, and submit.

Before you file an issue

  1. Search existing issues first.
  2. If it’s a crash / bug, include:
    • Device + OS version (macOS/iOS + version)
    • Diagnostics (includes Valdis version/build + system info)
      • macOS: menu bar → Valdis → About Valdis → Copy diagnostics
      • iOS: Valdis → Settings → About → Copy diagnostics
    • Steps to reproduce
    • Expected vs actual behavior
    • Screenshots / screen recording (if helpful)
    • Logs only if you’re comfortable sharing them (Valdis is privacy-first; logs don’t include chat/prompt content or secrets)

Debug logging

Valdis includes an optional Debug logging mode. When enabled, you can copy recent app logs to include in bug reports.

  • macOS: Menu bar → Valdis → About Valdis → Debug logging
  • iOS: Valdis → Settings → About → Debug logging
  • Restart the app after changing the setting.
  • After restart, use Copy logs (toolbar button) to copy recent logs.
  • Logs exclude sensitive content (prompts, context, message text, and secrets).

Screenshots

macOS: Enable iOS: Enable
macOS Debug logging toggle iOS Debug logging toggle
macOS: Copy logs iOS: Copy logs
macOS Copy logs button iOS Copy logs button

Reset flags (macOS)

If Valdis behaves strangely after an update (or when asked by a maintainer), you can start from a clean state using command‑line reset flags.

⚠️ These actions are destructive and cannot be undone. Only use them if you understand what will be deleted.

  • --reset-settings — resets app settings
  • --reset-data — resets app data (provider instances, model selections, cached state)
  • --reset-history — clears chat history

Run (recommended)

open -a Valdis --args --reset-data --reset-settings --reset-history

Run (direct binary)

/Applications/Valdis.app/Contents/MacOS/Valdis --reset-data --reset-settings --reset-history

What to report here

✅ Bugs, UX issues, performance problems
✅ Feature requests & product ideas
✅ Docs / website issues

What not to post

❌ Secrets (tokens, keys), private conversation content, personal data

Security

If you believe you found a security issue, do not open a public issue. Email: security@valdis.app

Thanks ❤️