Overview
A Project in AIDEN represents a software codebase that you want to build or enhance with AI assistance. Projects are the top-level container for all your work — stories, epics, agents, and Git operations.
Project Sources
AIDEN supports three ways to create a project:
New Project
Start from scratch. Provide a name, select a project type (Next.js, React, Python, etc.), and write an initial prompt describing what you want to build. AIDEN will scaffold and analyze the project.
From Repository
Connect your GitHub account via OAuth, select a repository and branch, and AIDEN clones it locally. The project is linked to GitHub for PR automation.
From Folder
Point AIDEN to any existing local directory. It scans and analyzes the codebase as-is.
Project Analysis
Every new project goes through an AI-powered analysis phase:
- Scan — AIDEN reads the file tree, identifies key files (entry points, configs, READMEs), and collects metadata
- Analyze — The AI generates a comprehensive summary: tech stack, architecture, existing functionality, and suggested stories
- Context Generation — AIDEN writes structured context files to your project:
.aiden/CONTEXT.md— Project overview for AI agents.aiden/SPEC.md— Specification document.aiden/STACK.md— Technology stack details.aiden/STORIES.md— Suggested stories for implementation
Project Types
| Type | Description |
|---|---|
NEXTJS | Next.js application |
REACT | React SPA |
PYTHON | Python project |
NODE | Node.js backend |
ELECTRON | Electron desktop app |
OTHER | Any other project type |
Data Storage
All project data is stored locally in SQLite. The database contains project metadata, analysis results, stories, chat sessions, and Git tracking data. No data is sent to external servers except for AI API calls during analysis and agent runs.