zoitrix
v1.2.2
Published
Zoitrix CLI — Cloud AI developer agent with credits and BYOK support
Maintainers
Readme
Zoitrix CLI
The Zoitrix CLI brings the Zoitrix developer workflow to a local terminal. It can generate code with Zoitrix Cloud AI, write reviewed file blocks, run local build commands, manage Git work, deploy static sites, and inspect account MCP connections.
Install
npm install -g zoitrixOr run it without a global installation:
npx zoitrix --helpThe CLI supports Node.js 18 or later.
Live app URL
By default the CLI links to the live web app at https://vibe-weaver.pages.dev. Override this for staging or local testing:
export ZOITRIX_APP_URL=https://vibe-weaver.pages.devAuthenticate
Create a personal API key at https://vibe-weaver.pages.dev/api. The CLI stores it in the operating-system keychain when available, with a permission-restricted local fallback.
zoitrix login
# or
zoitrix login --open
# or
zoitrix login --api-key vw_your_personal_keyVerify connectivity, account status, and BYOK readiness:
zoitrix doctor
zoitrix doctor --json
zoitrix whoami
zoitrix whoami --jsonDiscussion mode
Use Discussion mode to brainstorm architecture, compare approaches, troubleshoot, or refine requirements without creating files, generation jobs, shell commands, or local changes.
zoitrix discuss "How should I structure role-based access control?"
zoitrix discuss
zoitrix discuss "Review this architecture choice" --jsonGenerate with Zoitrix Cloud AI
zoitrix generate \
--goal "Build an accessible project dashboard" \
--platform web \
--mode balanced \
--out ./srcUse --dry-run or --plan to preview generated files without writing them. Add --json for machine-readable output and --yes for non-interactive writes.
Use a saved BYOK profile
zoitrix doctor
zoitrix generate \
--goal "Add a billing settings screen" \
--byok-profile <profile-id>Local developer commands
zoitrix read src/App.tsx
zoitrix write src/message.ts "export const message = 'Hello';"
zoitrix ls src
zoitrix ls src --json
zoitrix grep "function" --recursive
zoitrix exec "npm run build"
zoitrix install --dry-run
zoitrix build --dry-runSettings
zoitrix config list
zoitrix config get defaultMode
zoitrix config set defaultMode balanced
zoitrix config pathAPI keys and the GitHub token are secrets managed with zoitrix login / zoitrix login --github.
Git and deployment
zoitrix status
zoitrix status --json
zoitrix commit "feat: improve onboarding"
zoitrix pushDeploy a built static site through the same deploy-bridge path used by the web app:
npm run build
zoitrix deploy --project-id <project-id> --name "My App" --verify
zoitrix deploy --project-id <project-id> --dir dist --jsonYour personal API key needs the deploy scope. Create or update keys at https://vibe-weaver.pages.dev/api.
MCP connections
The CLI does not ship hard-coded MCP edge functions. It lists the MCP servers you have enabled in the web app and probes any stored https:// URLs through mcp-proxy.
zoitrix mcp --list
zoitrix mcp --status
zoitrix mcp --list --jsonManage connections in the web app at https://vibe-weaver.pages.dev/mcp.
Documentation
CLI help links to the in-app docs route:
https://vibe-weaver.pages.dev/docs
Security
- Do not pass API keys on a shared shell or commit them to Git.
- Zoitrix Cloud AI requests are authorized with your scoped personal API key.
- Zoitrix credits are deducted on the server for Cloud AI requests.
- BYOK provider secrets remain in the encrypted Zoitrix profile store and are not returned to the CLI.
zoitrix doctorandzoitrix whoami --jsonshow only non-secret account metadata.
Development
npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run