Projects
Projects are the top-level container in DevSpec. A project groups together everything related to a piece of work: one or more Git repositories, linked documents, database connections, and all conversations and sessions. The AI has context across everything in the project when you ask questions, so answers draw from your code, schema, and prior discussions simultaneously.
Creating a Project
Navigate to the Dashboard and click "Create Project." Give your project a name, choose an icon, and add an optional description. Once created, you can connect repositories, databases, and start AI sessions scoped to that project. The project card shows at-a-glance stats including the number of connected repos, sessions, and databases.
Steps
- Navigate to the Dashboard from the sidebar.
- Click "Create Project" to start.
- Enter a project name and choose an icon.
- Add an optional description for context.
- Once created, connect repositories, databases, and start AI sessions scoped to this project.
Multi-Repo Support
Many real projects span multiple repositories, including a frontend, a backend, a shared library, infrastructure-as-code, and more. DevSpec lets you add all of them to a single project. The index covers every repo in the project, so cross-repo queries work naturally. For example, you can ask "What depends on the auth-utils package across all our repos?" and get a unified answer.
Cross-repo queries work naturally. Ask "What depends on the auth-utils package across all our repos?" and get a unified answer spanning every connected repository.
Project Detail View
The project detail page is organized into tabs for Sessions, Repos, and Databases. Use Sessions to pick up a previous conversation or start a new one. Use Repos to see which repositories are connected, their indexing status, and freshness. Use Databases to view connected database schemas. This tabbed layout keeps everything accessible without clutter.
Project Settings
Access project settings to rename, update the description, change the icon, or delete the project. Deleting a project removes all associated sessions, action items, and repository links.