Docs/Quickstart

Quickstart

Initialize once, run Basecamp during environment setup, then work inside the ready sandbox with native project tools.

New to Basecamp?Start with the quickstart →

1. Install Basecamp

curl -fsSL https://basecamp.sh/install.sh | sh

2. Initialize the project once

From the root of an existing Rust project:

basecamp init

Basecamp detects native Rust project files, creates basecamp.lock, and synchronizes the first environment. Commit the environment lock with the repository.

3. In a new sandbox, run the setup step

git clone ...
cd your-project
basecamp sync

This is the Basecamp boundary: prepare the environment before the coding workload begins. In a managed agent sandbox, put this in its setup hook. In a reusable sandbox platform, you can run it while building a template or snapshot.

4. Hand over a ready environment

basecamp shell
cargo build
cargo test

Basecamp supplies the environment. Cargo still performs the build and test.

When project inputs intentionally change

basecamp update

sync reproduces a committed lock; update is the explicit environment change operation.

Network-isolated sandbox

# connected machine
basecamp bundle pack

# isolated sandbox
basecamp bundle unpack project.basecamp
basecamp shell
cargo build --offline --locked

Read the sandbox integration model →