1. Install
The CLI needs Node.js 18+. Install it globally:
npm i -g devaegis
devaegis --version2. Sign in
Copy your CLI secret key from the dashboard under Settings → Security. It starts with dae_. Then run:
devaegis setup
# ? Enter your DevAegis secret key: ••••••••
# ✓ Authenticated as you@example.comThe key is saved in ~/.devaegis/config.json. Treat it like a password.
3. Link the project
Create the project in the dashboard first (Protected projects → Protect a project) and copy its project ID. Then, in your project's root folder:
devaegis secure YOUR_PROJECT_ID
# ✓ Project Acme Storefront linkedThis writes a small .devaegis file and adds it and dist-secured/ to your .gitignore. The framework is detected from your package.json: Next.js, Vite, React (Create React App), or Express / Node.js.
4. Export and deliver
One command builds your project, encrypts the server code and writes the result to dist-secured/. You don't need to add any package or middleware to your app: the protection is built into the export.
devaegis export
# ✓ Export complete
# Output: dist-secured/
# Encrypted: 248 server filesDeliver the dist-secured/ folder. Your client runs it like any Node app:
cd dist-secured
npm install
npm start.env files are never exported. If the app reads environment variables at runtime, the export lists their names in dist-secured/.env.example so they can be set on the server.
For Vite and Create React App projects, browser code is still visible in devtools, as with any single-page app. Payment enforcement still works.
Pausing and restoring a site
You control the delivered site from the dashboard, not the CLI. On the project page, switch it to Suspended and the site shows a payment screen from its next status check. Switch it back to Live, or mark a linked invoice paid, and it comes back. If our servers can't be reached, the site stays up.
All commands
devaegis setupSign in with your CLI secret keydevaegis secure <project_id>Link the current folder to a DevAegis projectdevaegis exportBuild, encrypt and write the deliverable to dist-secured/devaegis statusShow who you're signed in as and the linked project's statusdevaegis unlockGet the decryption key for a paid project, once you allow it in the dashboarddevaegis --versionShow the installed CLI versionTroubleshooting
"Not logged in"
Run devaegis setup again. If you regenerated your secret key in the dashboard, the old one stops working.
"No project linked in this directory"
Run devaegis secure <project_id>from the project's root folder, the one with package.json.
The exported site shows 404s or 500s
Usually a missing environment variable. Check dist-secured/.env.example and set every name on the server.
Still stuck?
Email support@devaegis.com with the output of devaegis status.
