Getting started

Quickstart

From zero to a synced, encrypted environment in five steps.

Authenticate the CLI

Run packshell auth. It opens the website, you sign in, and approve the device. A keypair is generated locally and your public key is published so teammates can wrap project keys for you.

terminal

$ packshell auth

Initialize a project

From inside your repository, link or create a project. This generates the project encryption key locally and registers the project under a company.

terminal

# create a project in a new company$ packshell init "web-frontend" --company-name "Acadable Labs"# or link into an existing company$ packshell init --company-id co_9f2a7b1e

Push your .env

Encrypt the local .env and upload it as the first version of the default environment.

terminal

$ packshell push

Invite a teammate

Invite by email and, when they already have a published key, share the project key in the same step. They redeem the code with packshell join.

terminal

$ packshell invite teammate@company.com --role member

Pull on another machine

Anyone with the project key pulls and decrypts the latest version locally.

terminal

$ packshell pull --env production

Keep it in sync automaticallyRun packshell watch in a spare terminal to auto-pull whenever a newer remote version appears.

Check your status anytime

terminal

$ packshell status

That's the whole loop: init once, then push and pull as your environment changes. The rest of these docs explain what's happening underneath and the full command set.