Skip to main content

Import your codebase

This page covers how to bring a code repository into Artemis as a Project.

Getting started​

Open Projects in the sidebar and click New. The menu offers four ways to start:

  • Connect Git Repository: import a repository from your Git provider. This is the usual route.
  • Open a sample project: import a ready-made project to try Artemis on real code.
  • Upload a .zip file: create a Project from an archive of your code.
  • Start from scratch with a Plan: describe what you want to build and let the planning agent create a Project and a Plan.

If you have no Projects yet, the page shows the same choices as cards: Try a Sample, Connect Git Repository and Start with AI.

Connect a Git repository​

Connect Git Repository opens the import page. Select your Git provider (GitHub, GitLab, Azure DevOps or Bitbucket) and choose how Artemis reaches it:

  • GitHub App (recommended for GitHub): one-click setup with pull requests and automatic sync. Install it on your account or organisation, then pick a repository.
  • Access token: a personal access token for your provider.
  • SSH Key: works with any Git host, but SSH keys cannot open pull requests or use other GitHub integration features.

You can add tokens and keys here or beforehand under Platform Settings → Git. See Git Integration for the key types and how to create them.

Pick the repository from the list, or enter its URL. Then set the Project name and the branch Artemis should work from, and import.

Upload a .zip file​

Choose Upload a .zip file, drop the archive into the dialog, give the Project a name and an optional description, and create it. Only .zip archives are supported. A Project created from an archive has no Git repository attached.

Open a sample project​

Open a sample project lists ready-made codebases, such as small simulations whose measured frame rate you can watch improve. Choose one and click Import project.

Start from scratch with a Plan​

Start from scratch with a Plan opens the planning screen. Describe your idea, or pick a starter such as CLI tool or Task manager. The planning agent asks clarifying questions and writes a Plan with implementation steps. See Plan overview.

Next steps​

Last updated on by Mike Basios