opening projects

Twig works with Git repositories on your local machine. This page covers how to open, manage, and switch between projects.

opening a project

from the welcome screen

When you first launch twig (or have no project open):

  1. Click "open project"
  2. Navigate to a folder containing a Git repository
  3. Select the folder and confirm

from the menu

With twig already open:

  1. Go to file > open project (or cmd + o)
  2. Select your repository folder
  3. The project will open in the current window

cloning from github

To start with a repository you don't have locally:

  1. Go to file > clone repository
  2. Enter the GitHub URL
  3. Choose where to save it locally
  4. Twig will clone and open the project

project requirements

Twig works best with:

  • git repositories - the folder must be a Git repo (contain a .git directory)
  • local files - the project must be on your local machine
  • read/write access - twig needs permission to read and modify files

Projects without Git won't have workspace features available.

recent projects

Twig remembers projects you've opened:

  • Access recent projects from file > open recent
  • Recent projects appear on the welcome screen
  • Remove projects from the list by right-clicking

switching projects

To work on a different project:

  1. File > open project (or cmd + o)
  2. Select the new project

This closes the current project and opens the new one.

multiple projects

Currently, twig works with one project at a time per window. To work on multiple projects simultaneously, open additional twig windows.

project settings

Each project can have its own settings:

  • PostHog project connection
  • Workspace configuration
  • Editor preferences

Access project settings from the gear icon or preferences menu.

troubleshooting

"not a git repository"

Twig requires Git. Initialize Git in your project:

cd your-project
git init

permission errors

Ensure you have read and write access to the project folder. On macOS, you may need to grant twig disk access in system preferences > security & privacy > privacy > files and folders.

large projects

Very large repositories may take a moment to index. Twig will show a loading indicator while it processes the project structure.