Skip to main content

Set up a personal project with folders and tools

You create a personal project, add a folder and a repository, and grant a local MCP command exactly the tools it may use.

  • SpecWithCode
  • 1:21
  • Any agent
  • Captioned, no sound

Recorded on SpecWithCode 0.2.0, added 9 October 2026. The current release is SpecWithCode 1.0.44.

Before you start: SpecWithCode installed.

Length 1:21Captions

Steps

  1. Start a Personal project. It uses app-managed storage on its device and needs no Git repository.
  2. Add an existing folder and save its access grant. The folder is not moved.
  3. Add a repository URL and associate your local checkout. Match checks the checkout’s actual remote.
  4. Save a local MCP command, then choose Check to discover its tools. Check does not verify an external account.
  5. Grant exactly the tools this project may use. Revoke removes future access; restoring needs a new check and new grants.

Transcript

Built from the on-screen captions of this silent video.

0:00 A Personal project

This Personal project uses app-managed storage and starts without a Git repository. Personal projects keep the same project-specific memory, routines and usage views.

0:14 Storage and extra folders

Its execution device owns the storage. Extra folders and repositories are optional. Add an existing synthetic folder and save its access grant. This does not move the folder.

0:29 Link a repository

A repository URL can coexist with that folder. Associate the owned local checkout before saving. Match checks the checkout's actual remote identity. This walkthrough performs no network clone.

0:44 Add a local MCP command

Save a local MCP command separately. This example is an owned, inert discovery fixture. Check discovers MCP tools. It does not verify a Gmail, Calendar or other external service account.

0:58 Grant and revoke tools

Choose and save exactly the tools this project may use. Calls still follow SpecWithCode's approval rules. Revoke removes future access. Restoring requires a new discovery check and fresh tool grants.

1:13 What ran on the device

The command runs as the device's user. No external account or AI provider was contacted in this walkthrough.

Read the projects guide

All tutorials