axiomstudio/axiomcloud repository overview

⁠axiomcloud

⁠Run frontend in dev mode

1. cd axiomcloud/frontend
2. npm run dev
3. set env var AXIOMCLOUD_DEV_FRONTEND_URL=http://localhost:5173⁠
4. run axiomcloud, this should proxy axiomcloud UI to dev instance

⁠axiom-test-client

⁠Setup everything from YAML config

axiom-test-client setup
--url http://localhost:8080⁠ --token
--config mock-servers/mock-servers.yaml
--mcp-auth-token "eyJhbG..."

⁠Clean up everything

axiom-test-client cleanup
--url http://localhost:8080⁠ --token

⁠Clean up only LLM Gateway resources

axiom-test-client cleanup --llm-gateway
--url http://localhost:8080⁠ --token

⁠Clean up only MCP Gateway resources

axiom-test-client cleanup --mcp-gateway
--url http://localhost:8080⁠ --token

⁠Identity provider configuration (OAuth sign-in)

axiomcloud supports three identity providers: Google, GitHub, and Microsoft (Entra ID). Each is enabled by setting a client ID env var; unset variables disable that provider's sign-in button and the corresponding /auth/<provider> route returns 503.

Redirect URIs to register with each provider:

• Google: <BASE_URL>/auth/google/callback
• GitHub: <BASE_URL>/auth/github/callback
• Microsoft: <BASE_URL>/auth/microsoft/callback

For Microsoft specifically, set the Entra app's Supported account types to "Accounts in any organizational directory and personal Microsoft accounts" to match the common tenant default, and grant admin consent for the openid, email, profile, and User.Read Microsoft Graph delegated permissions so end users don't see a consent prompt on first sign-in.