Clone a Repository and Open Your Project

Clone a repository from the agent terminal to put a working copy on your TermSquad computer. Use a folder under your home directory so Files and your coding agents can work with it.

Clone with GitHub CLI

Connect GitHub first if the repository requires authentication. Replace OWNER/REPOSITORY with the repository you intend to clone:

mkdir -p ~/projects
cd ~/projects
gh repo clone OWNER/REPOSITORY
cd REPOSITORY

Replace the final folder name if the repository uses another name. GitHub’s clone command reference covers accepted repository formats.

For a non-GitHub repository, use its documented Git clone URL and authentication method.

Check the project

Run:

pwd
git status

Read the README and any repository instructions before installing dependencies or asking an agent to make changes. Use the project’s required language versions and package manager.

Open Files → projects → your repository to browse it visually, or connect a desktop editor through Remote SSH.

Start an agent in the right folder

Launch your agent after entering the repository. Ask it to explain the project and identify its setup and test commands before editing.

If cloning fails with a permission error, check the account and repository access. If the destination already exists, inspect it rather than deleting it or cloning over unknown work.

Continue with project dependencies and Git commits and pull requests.