Skip to main content
Creates the project and marks this exact directory as belonging to it. Run it inside the directory you want archived. It never walks up to an enclosing git root, which is what lets a subfolder of a monorepo be its own project.

​
What else it does

It registers the directory with the background daemon and starts it if it is not already running. That is what makes syncing automatic from here on, roughly every 20 seconds, with no command to run. See daemon.
On an OS with neither launchd nor systemd the CLI cannot install a background service. It says so, and on those machines sync has to be run by hand.

​
What it prints

The project’s MCP URL, and a pointer to resumecontext mcp for the token your agent needs. Add that MCP server only to this directory’s folder-level agent configuration, never to a global agent configuration.

​
Running it twice

Not an error. If the directory already has a marker, either because you ran init before or because the marker was committed to git and you just cloned the repo, init looks the project up and reports your relationship to it:
There is no way to create a project from the website. init writes the marker file that ties a directory to a project id, and a browser has no directory.

​
Invited projects

Do not use init to join an existing project. After accepting an invite, run sync once from a clone that contains the project’s .resumecontext.json marker. That registers the clone with the daemon and makes later syncing automatic.