Tickzy — User Guide
Plan and track work in projects, move tickets through a clear workflow, and optionally pair Tickzy with Gitzy when you want tickets next to your repository work.
What Tickzy does
Tickzy focuses on issues and tasks, not source control. You get fast ticket creation and editing, project-based organization, and filters that keep backlog views manageable. Data is local-first: projects and tickets live on your device, with optional storage and backup choices described under Storage & backup.
Projects
Create and organize projects, open a project to see its tickets, and keep a dedicated inbox-style flow where it applies.
Tickets
Full ticket lifecycle: title, description, notes, type, status, priority, and metadata. Edit, delete, or close tickets as your workflow requires.
Optional Gitzy
Link a ticket to a repository path, attach linked commits, and jump between Tickzy and Gitzy with deep links—without either app requiring the other.
Projects
The Projects tab lists your projects with ticket counts. Create a project, rename it, pick an accent color, and open it to work inside that scope. An inbox-style project may appear for quick capture workflows; regular projects stay separate for focused boards.
Project detail
Open a project to see tickets belonging to it, sort and reorder where supported, and move work forward without leaving the project context.
Tickets
The Tickets tab gives an aggregate view across projects: filter by status (for example open, in progress, closed), scan titles and badges, and open any ticket for full detail.
Fields
Tickets support a title, long-form description, notes, type, status, priority, and project assignment. Create, edit, delete, or close tickets as your process requires.
Repository & commits (optional)
When you link a repository to a ticket, Tickzy stores a stable identifier for that path so “Open in Gitzy” and timeline features can target the same repo Gitzy knows about. You can attach linked commits (hash and optional message snippet) and open them in Gitzy when installed.
Status, priority & types
Tickzy uses structured fields so lists stay scannable: status reflects where a ticket sits in your process, priority signals urgency, and type helps group bugs, chores, or features. Badges in lists make these visible at a glance without relying on color alone when combined with labels.
Storage & backup
Tickzy persists data in its app container. You can choose storage that stays on this device only or use iCloud according to the options presented in Settings, so ticket data can follow your account when that mode is enabled.
Backup & restore
Optional backup and restore flows let you protect your work. Treat backup as user-directed: know what is included in an export or backup before you rely on it for disaster recovery.
Gitzy companion
Gitzy is a separate Git client. Tickzy does not bundle Git operations; instead, both apps share conventions through shared identifiers and links. You can use Tickzy standalone forever, or add repository links and linked commits when you also use Gitzy.
Ticket references in commits
When Gitzy shows a commit whose message references a ticket (for example #42, fix #42, closes #42), tapping the badge can open Tickzy to that ticket. If the ticket does not exist yet, Tickzy can offer to create it.
Open in Gitzy
From a linked repository or commit, Tickzy can hand off to Gitzy using gitzy:// URLs so you land on the right repository or commit. If Gitzy is not installed, Tickzy shows a short message instead of failing silently.
Deep links
Tickzy registers URL schemes so other apps and shortcuts can open specific content:
tickzy://ticket/<id>— Opens the Tickets tab and navigates to the ticket with that identifier, or offers to create it.tickzy://project/<id>— Opens the Projects tab and navigates to the matching project.
Gitzy may emit links into Tickzy when commit messages contain parseable ticket references.
Settings
Open Settings from the tab bar for app information, storage mode, companion and support links, AI configuration, appearance (including dark mode via system or app theme), and legal documents. Version and build numbers appear for troubleshooting.
Support
Rate the app, read this manual, send feedback, or contact support using the entries provided. Responses depend on channel and availability.
AI
AI features are optional and user-controlled. When enabled, they may help with ticket titles, triage suggestions, or summaries depending on the current app version and your settings. Remote or on-device behavior follows the disclosures in the app: nothing runs until you opt in and trigger flows that the UI describes.
Your data
Ticket text may be processed by the provider you select (for example on-device or a configured endpoint). Review in-app privacy copy before enabling cloud or experimental providers.
Privacy & data
Tickzy is built for no advertising and no cross-app tracking as part of its product positioning. Project and ticket content stays under your control on device unless you turn on iCloud storage, use backup/export, or invoke features that send text to an AI provider.
Practical summary
Read the in-app privacy policy for binding terms. App Store privacy labels should match the build you ship: declare diagnostics only if you actually transmit crash data, and declare off-device processing only when ticket or project content is sent to third-party services you configure.