Your First Project
Connect a repository and run your first parallel AI agents.
This guide walks you from a fresh install to having two agents working simultaneously on your codebase. By the end, you'll have experienced the core Innovatic workflow.
Connect a repository
Innovatic works with any local Git repository.
- Launch Innovatic
- Click "Open Repository" on the welcome screen
- Select the root folder of your project
Innovatic scans your project, loads the branch structure, and opens the workspace.
Make sure your repository has no uncommitted changes on the main branch before connecting. A clean working tree ensures agents can start fresh in their own isolated branches.
Get oriented
Once your repository is open, the workspace is organized into three main areas:
- Board — your kanban-style view of all agent conversations, organized by status
- Sidebar — live output from whichever conversation is selected: messages, file changes, and progress
- Repository panel — branch overview, current status, and merge controls
Each card on the board represents one agent working on one task.
Start your first conversation
- Click "New Conversation" or the + button on the board
- Write a clear, specific task description — the more context you give, the better the result
- Choose a work mode that matches the task:
| Mode | When to use it |
|---|---|
| Feature | Building new functionality |
| Bug | Diagnosing and fixing an issue |
| Plan | Designing architecture or breaking down a complex feature |
| Review | Reviewing recent changes for quality and correctness |
| Question | Asking questions about the codebase without modifying it |
- Leave the model on Auto — it selects the best model for your task automatically
- Press Send
Innovatic creates an isolated branch for the agent and starts working immediately.
Launch a second agent in parallel
This is what sets Innovatic apart. While the first agent is running:
- Click "New Conversation" again
- Give it a different task — ideally one that touches different parts of the codebase
- Press Send
Both agents are now working simultaneously, in complete isolation from each other. They can't overwrite each other's changes.
Two to three parallel agents is a good starting point. Each agent runs independently and uses your API quota, so start at a pace you're comfortable with.
Follow the progress
The board updates in real time:
- Each card shows the agent's current status — thinking, writing code, waiting for input
- Click any card to open it in the sidebar and read the full conversation as it streams
- File changes appear as they happen, so you can see exactly what the agent is touching
Review and merge
When an agent finishes:
- Open the conversation from the board
- Review the changes in the Diff Viewer — file by file, line by line
- If everything looks good, click Merge to integrate the work into your main branch
- If you want adjustments, type a follow-up in the same conversation — the agent continues from where it left off
Each agent branch is a real Git branch. You can also inspect and merge changes using your own Git tools or any external IDE.
Tips for getting started
- Break work into independent tasks. The more self-contained each task is, the smoother the parallel workflow.
- Use Plan mode for complex features. Let one agent design the breakdown, then assign the pieces to Feature mode agents.
- Review early. Check in on agents as they work rather than waiting for everything to finish at once.