Skip to main content

Adding a Project

Navigate to the root directory of your repository and run:
This registers the folder as a project. Run ami to open the chat interface. Alternatively, running ami in an unregistered repository automatically prompts you to create a project.

Switching Projects

From the Terminal

Navigate to a registered project’s folder and run ami. This automatically opens the correct project in the interface.

From the Interface

Press Cmd+K to open the command palette and search for a project by name. Alternatively, click the project name in the sidebar to view all your projects.

Project Rules

ami looks for guidance files in your codebase to understand project structure, conventions, and commands.

Supported Files

ami reads all of the following files if they exist. Contents are combined and deduplicated: Put your build commands, test commands, code conventions, and architecture notes in these files. ami reads them automatically.

Example AGENTS.md

Include lint commands in AGENTS.md. ami runs them automatically after making changes if it knows what commands to use.