Getting Started

Welcome to KiraPilot! 🚀 This guide will help you get up and running with your new productivity companion in just a few minutes.

Quick Start

Ready to boost your productivity? Follow this guide to set up KiraPilot and create your first task in under 5 minutes.

What is KiraPilot?

KiraPilot is a modern productivity powerhouse that brings together:

📋

Smart Task Management

Organize work with intelligent scheduling and priority management

⏱️

Built-in Time Tracking

Track your time effortlessly with integrated timers and analytics

🤖

AI Assistant

Chat with Kira for suggestions, task creation, and productivity insights

🔒

Privacy First

All data stays local with SQLite storage - no cloud, no worries

Built with privacy in mind, KiraPilot stores all your data locally using SQLite, ensuring your productivity information never leaves your device.

Installation

Progress:

Step 1 of 4

System Requirements

Platform	Requirements
🍎 macOS	10.15 (Catalina) or later
🪟 Windows	Windows 10 version 1903 or later
🐧 Linux	Ubuntu 18.04, Debian 10, or equivalent

Download and Install

Visit the releases page

Head to the KiraPilot releases page to download the latest version.

Choose your installer

• macOS: Download the .dmg file
• Windows: Download the .msi installer
• Linux: Choose .AppImage or .deb package

Run the installer

Double-click the downloaded file and follow the setup wizard. The installation takes about 30 seconds.

Launch KiraPilot

Find KiraPilot in your applications folder (macOS), start menu (Windows), or applications menu (Linux) and launch it.

First Launch Setup

When you first open KiraPilot, you'll see a clean interface with three main views:

1. Week View (Default)

The main planning interface where you'll organize your tasks across the week. You'll see columns for:

• Backlog: Unscheduled tasks
• Upcoming: Tasks for future dates
• Daily columns: Monday through Sunday

2. Day View

A focused view for the current day's tasks and schedule.

3. Reports

Analytics and insights about your productivity patterns.

Creating Your First Task

Progress:

Step 3 of 4

Let's create your first task to get familiar with KiraPilot:

Open the task creator

Click the "+" button in the top-right corner of any column to open the new task dialog.

Enter task details

• Title: "Learn KiraPilot basics" (be specific!)
• Description: Add context using the rich text editor
• Time estimate: How long will this take?

Set priority level

🔴

Urgent

Critical tasks, emergencies, hard deadlines

🟡

High

Important tasks with near-term deadlines

🔵

Medium

Regular work tasks (default)

⚪

Low

Nice-to-have tasks, learning

Add tags (optional)

Use tags like work, personal, learning to categorize your tasks for easy filtering.

Create the task

Click "Create Task" and watch it appear in your Backlog column, ready to be scheduled!

Scheduling Tasks

To schedule a task for a specific day:

1. Drag and drop the task from Backlog to any day column
2. Or click the task and use the "Schedule" option in the task modal
3. Tasks scheduled for today will appear in the current day column

Starting Your First Timer Session

Time tracking in KiraPilot is seamless:

1. Click on any task to open the task details
2. Click the "Start Timer" button (play icon)
3. The timer will appear in the header, showing elapsed time
4. Work on your task - the timer runs in the background
5. Click "Stop Timer" when you're done or need a break
6. Add session notes (optional) to record what you accomplished

The timer automatically tracks:

• Total work time
• Break time (when paused)
• Session productivity metrics

Meeting Your AI Assistant

Progress:

Complete!

Meet Kira

KiraPilot includes an intelligent AI assistant powered by Google Gemini that can help with task management and productivity insights.

Access the AI assistant

Click the floating AI button (🤖) in the bottom-right corner to start chatting with Kira.

Set up Google Gemini (optional)

If prompted, get your API key from Google AI Studio for enhanced AI capabilities.

Start chatting

Try these natural language commands:

• "Create a task to review quarterly reports"
• "Show me my tasks for tomorrow"
• "Start a timer for my current task"
• "How productive was I this week?"
• "Schedule my high-priority tasks for tomorrow"

Pro Tip

The AI assistant has access to all your tasks and time data through specialized tools, making it a powerful productivity companion that truly understands your workflow.

Understanding Task Lists

KiraPilot organizes tasks into lists for better organization:

• Default List: Your main task list (created automatically)
• Custom Lists: Create additional lists for different projects or contexts
• List Filtering: Use the dropdown in the header to filter tasks by list

To create a new task list:

1. Click the task list dropdown in the header
2. Select "Manage Lists"
3. Click "Create New List"
4. Give it a name and description

Key Interface Elements

Header Bar

• Task List Selector: Switch between different task lists
• View Toggle: Switch between Week and Day views
• Timer Display: Shows active timer and controls
• Settings: Access preferences and configuration

Task Cards

Each task shows:

• Title and description
• Priority indicator (colored dot)
• Time estimate vs. actual time
• Tags (if any)
• Status indicators

Drag and Drop

• Move tasks between columns to reschedule
• Reorder tasks within columns by priority
• Visual feedback shows valid drop zones

Customization Options

Access Settings (⚙️) to customize:

Appearance

• Theme: Light, dark, or system preference
• Color scheme: Accent colors and UI preferences
• Font size: Adjust for readability

Productivity

• Work session length: Default timer duration
• Break reminders: Automatic break suggestions
• Daily goals: Set targets for tasks or time

Privacy

• Data location: View where your data is stored
• Export options: Backup your data
• Clear data: Reset if needed

Quick Tips for Success

1. Start Small

• Begin with 3-5 tasks for your first day
• Use realistic time estimates
• Don't over-schedule initially

2. Use the Weekly View

• Plan your week on Sunday or Monday morning
• Drag tasks to specific days based on priorities and deadlines
• Keep some buffer time for unexpected tasks

3. Leverage Time Tracking

• Start timers even for small tasks
• Review your time data weekly to improve estimates
• Use session notes to capture insights

4. Experiment with the AI Assistant

• Ask for help organizing your tasks
• Request productivity insights
• Use natural language for quick task creation

5. Develop a Routine

• Check KiraPilot first thing in the morning
• Review completed tasks at the end of each day
• Plan the next day before finishing work

Next Steps

🎉 You're all set!

Now that you're up and running, dive deeper into KiraPilot's powerful features.

📚 Master the Essentials

📋

Task Management

Advanced organization, dependencies, and rich text features

⏱️

Time Tracking

Master timers, analytics, and productivity insights

🤖

AI Assistant

Natural language commands and smart suggestions

⚡

Shortcuts

Speed up your workflow with hotkeys

🎨

Customization

Personalize KiraPilot to match your style

🔍

Patterns

Understand your productivity patterns

🆘 Need Help?

Support Resources

Stuck on something? We've got you covered with multiple support options.

• 📖 Troubleshooting Guide - Common problems and solutions
• ❓ FAQ - Frequently asked questions
• 🐛 GitHub Issues - Report bugs or request features
• 💬 Community - Connect with other users

---

🚀 Welcome to KiraPilot!

We're excited to help you navigate your day with precision.