Frequently Asked Questions

General

What is Almirant?

Almirant is your mission control for projects where humans and AI agents work together. It is not "another project management tool with AI integration." It is the place where you define what needs to be done, assign work to AI agents, and watch them execute in real time.

The key difference: bidirectional connection with your IDE via MCP (Model Context Protocol). Your AI agent reads tasks, implements code, and updates the board without you leaving the editor.

Is it free?

Almirant has a free plan with full functionality for small teams. If you need more users, advanced integrations, or expanded limits, there are paid plans. Check almirant.ai/pricing for details.

What browsers are supported?

Almirant works on recent versions of all major browsers:

Browser	Minimum version
Chrome	90+
Firefox	90+
Safari	15+
Edge	90+

Can I use Almirant without AI?

Yes. Kanban boards, work items, sprints, documentation, Seeds, Goals, Todos, and Expenses all work perfectly without any AI integration. AI is optional: enable it when you want, where you want.

Projects and Boards

Can I have multiple boards in a project?

Yes. Each project can have as many boards as you need. It is common to have a main development board and additional boards for QA, design, or specific teams. Each board has its own configurable columns.

Can I transfer a project between organizations?

Yes. Administrators can transfer entire projects between organizations. The transfer includes all work items, boards, columns, sprints, and associated documents. Go to Project settings > General > Transfer project.

Can I customize board columns?

Yes. Each board's columns are fully customizable. You can add, remove, rename, and reorder columns. You can also mark columns as "done" so that work items in that column are considered completed.

What are board templates?

When creating a new board, you can choose from predefined templates (basic Kanban, Scrum, Bug tracking) or create one from scratch. Templates set up initial columns and workflows that you can modify later.

Work Items

What is the difference between a Story and a Task?

Work items follow a 4-level hierarchy:

Type	Purpose	Example
Epic	Large initiative that groups features	"Billing module"
Feature	Complete functionality within an epic	"PDF invoice generation"
Story	User story with business value	"As an admin, I want to generate PDF invoices"
Task	Specific, implementable technical work	"Implement PDF generation service"

In practice, stories describe what the user needs and tasks describe how it is technically implemented.

How do work item statuses work?

Work items do not have their own status field. The status is derived from the board column where they are located. If a work item is in the "In Progress" column, its status is "In Progress". If you move it to "Done", the status changes automatically. This simplifies management and ensures the board always reflects reality.

Can I archive work items?

Yes. You can archive work items that are no longer relevant without deleting them. Archived items disappear from the board but remain accessible via the "Archived" filter. You can unarchive them at any time.

Can I create dependencies between work items?

Yes. Almirant supports "blocked by" dependencies between work items. If an item depends on another that has not been completed yet, a visual indicator is shown on the board. See the Dependencies guide for more details.

Seeds, Goals, and Planning

What are Seeds?

Seeds are raw material for brainstorming. They are rough ideas you capture quickly before you forget them: a feature that came to you in the shower, user feedback, something the AI generated. You review them later, refine them, and convert them into real work items when they are ready.

Seeds can be in several states: draft, active (under active review), to_review (pending review), approved (ready to convert), archived (saved for later), or rejected (discarded).

Where do Seeds come from?

They can come from various sources:

• Manual: you create them directly
• Feedback: they come from user comments or suggestions
• AI generated: the AI generates them during planning sessions
• Import: imported from other tools

What are Goals and Milestones?

Goals let you track progress at the macro level. They are big objectives that group multiple work items: "Launch v2.0", "Stripe integration", "MVP for investor demo".

Each Goal has a status (planned, in_progress, completed, on_hold, cancelled), linked work items, and a progress percentage calculated automatically based on how many items are completed.

What are Planning Sessions?

Planning Sessions are AI chats for planning work. You describe what you want to build, the AI asks questions, and together you decompose the work into concrete tasks.

Sessions are multi-turn (continuous conversation), save history, have real-time streaming, and can generate work items directly on your board when you reach something concrete.

Todos and Expenses

What are Todos?

Todos are lightweight personal tasks. They are not work items (which live on boards and have all the ceremony of a project). They are things you need to do: "Review Juan's PR", "Reply to client email", "Buy domain".

Simple states: pending, in_progress, done, blocked. No sprints, no boards, no assignments. Just your personal list.

What is Expenses for?

Expenses lets you track project costs. Service subscriptions, hosting, paid APIs, freelancers, whatever. You can:

• Categorize expenses by type
• Mark recurring expenses (monthly, yearly)
• Use multiple currencies (EUR, USD, GBP, etc.)
• Attach invoices
• View spending reports by period

AI and Integrations

What AI models does Almirant support?

Almirant works with any IDE or tool that supports MCP (Model Context Protocol). The most common models are:

• Claude (via Claude Code) -- Recommended. Full MCP support
• GPT-4 (via Cursor) -- Supported via MCP
• Any other model accessible from an MCP-compatible IDE

The built-in AI planning in the web interface uses OpenAI or Anthropic models, configurable in the project connections.

Do I need Claude Code to use Almirant?

It is not required, but it is the IDE with the best integration. Claude Code natively supports MCP, which allows you to use the built-in skills (/implement, /review-task, etc.) directly. If you prefer another IDE, you can use any that supports MCP.

Does it work with Cursor?

Yes. Cursor supports MCP and you can connect it to Almirant the same way as Claude Code. Configure the MCP server in Cursor's settings with your project's URL and API key.

Does it work with other IDEs?

Almirant works with any tool that supports the MCP protocol. Currently the most common ones are Claude Code and Cursor, but the list of compatible IDEs is growing continuously.

Does Almirant replace Claude, Cursor, or Codex?

No. Almirant gives them a plan and coordinates their work. You already use AI agents. The problem is not the AI -- it is that they lack context about what needs to be done, in what order, and where to report progress. Almirant is the mission control they are missing.

MCP (Model Context Protocol)

What is MCP?

MCP (Model Context Protocol) is an open protocol that allows AI tools to communicate with external services in a standardized way. In the case of Almirant, MCP lets your IDE read tasks, create work items, move items between columns, and manage sprints directly from the editor.

How do I connect my IDE to Almirant via MCP?

1. Generate an API key in Settings > API Keys of your project
2. Copy the MCP server URL: https://api.almirant.ai/mcp?projectId=<your-project-id>
3. Configure the MCP server in your IDE (.mcp.json for Claude Code, Cursor settings)
4. Verify the connection by running a command like list_projects

See the full guide at Connect Claude Code.

Is the MCP connection secure?

Yes. The MCP connection uses HTTPS with API key authentication. Each key is scoped to a specific project. You can revoke keys at any time from the project settings. Data is transmitted encrypted and API keys are never exposed in logs.

Can I limit MCP access to a single project?

Yes. When configuring the MCP URL, include the projectId parameter to limit the scope. MCP tools will only be able to view and modify data for that specific project. Without projectId, access extends to all projects in the organization.

Billing and Plans

How much does Almirant cost?

Almirant offers several plans tailored to different needs. The free plan includes full functionality for small teams. Paid plans expand limits for projects, members, integrations, and storage. Visit almirant.ai/pricing to see current pricing.

Is there a free plan?

Yes. The free plan includes:

• Unlimited projects and boards
• Work items and sprints
• Seeds, Goals, and Todos
• Expense tracking
• Basic MCP integration
• 1 user

Paid plans add more users, advanced integrations, webhooks, more storage, and priority support.

Can I change plans at any time?

Yes. You can upgrade or downgrade your plan at any time from Settings > Billing. Changes take effect immediately and the cost is prorated based on the remaining days in the billing cycle.