Quickstart
1. Authenticate and connect the app
Section titled “1. Authenticate and connect the app”genaug auth login
genaug launch \ --app-root . \ --project-name "Commerce App" \ --project-slug commerce-app \ --issuer-url https://app.example.com \ --jwks-url https://app.example.com/.well-known/jwks.json \ --audience commerce-app \ --user-id-claim sub \ --callback-base-url https://app.example.com \ --env-file .env.local \ --waitlaunch creates or links the Project, commits its app-backend contract, installs one shared
Candidate runtime key into the ignored server environment file, and verifies the binding.
2. Add Project resources
Section titled “2. Add Project resources”genaug capability import openapi orders \ --spec ./orders.openapi.json \ --operation listOrders=orders.read \ --operation cancelOrder=orders.cancel \ --credential orders-api
genaug credential set orders-api --from-env ORDERS_API_KEYgenaug memory namespace create user-memory --scope user3. Create the Agent
Section titled “3. Create the Agent”genaug agent create support \ --purpose "Help signed-in customers manage their orders" \ --soul ./agents/support/SOUL.md \ --skill ./skills/order-support/SKILL.md \ --capability orders.read \ --capability orders.cancel \ --memory user-memory:read-write \ --connection app-backend \ --wait4. Test as an app user
Section titled “4. Test as an app user”genaug user link customer_123 --provider appgenaug agent test support --user customer_123 --jsongenaug run show <run-id>The test runs on General Augment infrastructure and produces immutable evidence for the exact Candidate, Agent, and app user.
5. Review and promote
Section titled “5. Review and promote”genaug release diff <release-id>genaug dashboard openWorkspace owners/admins may also run genaug release promote <release-id> from a freshly
authenticated interactive terminal and confirm the complete fingerprint.
6. Prove resource reuse
Section titled “6. Prove resource reuse”genaug agent create sales-assistant \ --purpose "Help customers choose products" \ --soul ./agents/sales/SOUL.md \ --skill ./skills/sales/SKILL.md \ --capability orders.read \ --memory user-memory:read \ --connection app-backendThe second Agent reuses the existing capability, credential, namespace, connection, and Project runtime key. Nothing is reinstalled.