Skip to Content
DocsQuick Start

1. Create a Project

Launch AIDEN and click New Project. You have three options:

  • New Project — Start from scratch with a name, type (Next.js, React, Python, etc.), and initial prompt
  • From Repository — Connect GitHub and clone an existing repo
  • From Folder — Point to an existing local codebase

2. Project Analysis

After selecting your source, AIDEN automatically:

  1. Scans your codebase — file tree, key files, entry points, dependencies
  2. Analyzes with AI — generates a summary, identifies the tech stack, architecture, and suggests stories
  3. Creates context files — writes .aiden/CONTEXT.md, SPEC.md, STACK.md, and STORIES.md to your project

3. Review & Import Stories

AIDEN presents the AI’s analysis with suggested stories. You can:

  • Edit story titles and descriptions
  • Select which stories to import
  • Organize them into epics

Click Save to populate your Kanban board.

4. Plan a Story

Click on any story in the Backlog column and drag it to Plan. Open the story to use the AI chat in planning mode — refine the spec, ask questions, and get suggestions.

5. Start an Agent

When a story is ready, click Start to begin implementation:

  1. AIDEN creates a Git branch: feature/s-{number}-{title-slug}
  2. Optionally creates a Git worktree for isolated work
  3. The AI agent gets full tool access — it can read/write files, run commands, and execute bash
  4. Watch real-time progress in the story chat

6. Review & Merge

When the agent completes its work:

  1. The story moves to Review
  2. AIDEN can automatically create a GitHub Pull Request
  3. Review the changes, approve, and merge
  4. The story moves to Done ✅

What’s Next?

InstallationProjects