Skip to content

Guides & Tips

The Getting Started section covers what Fox is and how each piece works. These guides go a step further — they're about the when and why. Practical workflows, configuration walkthroughs, and the power features that tie Fox into the rest of your toolkit.

Pick whichever guide matches what you're doing right now.

Planning & Structure

Make your project structure earn its keep. These guides walk through configuration from scratch and cover the decisions that affect how smoothly a project runs.

  • Setting Up a Project

    A step-by-step walkthrough for configuring a brand-new project — prefix, statuses, types, priorities, and the first batch of issues.

  • Versions vs. Milestones

    When to use one, when to use the other, and when to skip both. Worked examples from real-world projects.

  • Board Workflows

    Practical patterns for moving work across columns — triage, WIP limits, swimlane-style scoping, and more.

Finding & Connecting

Keep your work discoverable as your projects grow.

  • Search & Spotlight

    Full-text search, token queries, cross-project references, and system-wide Spotlight integration.

Power Features

Fox has several features that only pay off once you've been using it for a while — automation, deep linking, bulk import, and AI-assisted workflows. Reach for these when the basics aren't enough.

  • MCP Server

    The built-in Model Context Protocol server lets Claude Code, Cursor, and other AI tools query and manage your issues directly.

  • Shortcuts Automation

    Create, edit, fetch, and search issues from the Shortcuts app. Quick-capture, lock-screen actions, and multi-app workflows.

  • CSV Import

    Bulk-create issues from a spreadsheet. Automatic column mapping, preview, and project-specific attribute handling.

  • URL Scheme

    The fox:// deep link format. Share, automate, and wire Fox into other apps.

  • Keyboard Shortcuts

    The full shortcut reference for Mac and iPad — markup, navigation, and file commands.

Get Support

Have a question or found a bug? We'd love to hear from you.

Contact us