Cursor Agent Environment

Cursor cloud agent environment configuration

File match **/.cursor/environment.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/cursor-agent-environment/latest.json
Source https://cursor.com/schemas/environment.schema.json

Validate with Lintel

npx @lintel/lintel check

Defines a dev environment

All of

1. container object
2. common object

Definitions

common object
name string

The name of the environment.

user string

The user to run the environment as.

install string

The update script to run on VM startup (after pulling latest changes) to refresh dependencies.

start string

The start command to run when the environment is started.

repositoryDependencies string[]

Repositories that are required for the environment to work, and need to be included in the GitHub access token that is generated for the environment.

ports object[]

Ports to expose from the container. Similar to devcontainers port forwarding.

terminals object[] | object[]

The terminals to run when the environment is started.

container object
build object

Docker build-related options.

2 nested properties
dockerfile string required

The location of the Dockerfile that defines the contents of the container. The path is relative to the folder containing the environment.json file.

context string

The location of the context folder for building the Docker image. The path is relative to the folder containing the environment.json file.

snapshot string

A snapshot ID for the base environment.

agentCanUpdateSnapshot boolean

Whether the agent can update the snapshot.