Skip to content

feat(cli): add --project-config and global --env for multi-env deploys - #1627

Merged
jhaynie merged 1 commit into
mainfrom
feat/cli-project-config-and-env-flags
Jul 24, 2026
Merged

feat(cli): add --project-config and global --env for multi-env deploys#1627
jhaynie merged 1 commit into
mainfrom
feat/cli-project-config-and-env-flags

Conversation

@jhaynie

@jhaynie jhaynie commented Jul 24, 2026

Copy link
Copy Markdown
Member

Summary

  • Add --project-config <path> so project-aware commands (including deploy) can use an alternate agentuity.json (different project ids, domains, regions).
  • Add global, repeatable --env <path> to load env files in order (later overrides earlier), applied early into process.env and used by deploy env sync and cloud env push.
  • Document multi-environment deploy patterns and update CLI skills.

Example

agentuity deploy \
  --project-config agentuity.staging.json \
  --env .env \
  --env .env.staging

Test plan

  • bun test test/config/env-files.test.ts test/config/project-config-path.test.ts in packages/cli
  • bun run typecheck in packages/cli
  • agentuity deploy --help shows --project-config
  • agentuity --help shows global --env
  • Smoke: deploy with --project-config pointing at a staging config
  • Smoke: deploy/push with --env .env --env .env.staging and confirm later keys win
  • Confirm project import --env KEY:VALUE and session list --env=production still work (non-file --env values are skipped for file loading)

Allow the same codebase to target different Agentuity projects and env
files via --project-config and repeatable --env, with docs and skills.
@agentuity-agent

agentuity-agent Bot commented Jul 24, 2026

Copy link
Copy Markdown

The latest Agentuity deployment details.

Project Deployment Preview Updated (UTC)
docs 🔴 Failed (details) - 2026-07-24T01:42:34Z

exit code 17

View deployment logs with the Agentuity CLI:

agentuity cloud deployment logs deploy_aa5698344fa51ba1ca69938ec72b07e5 --project-id=proj_5ed7da797bef771d65e1bd6946a052b1

@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 47 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1ca5b455-2527-4801-99c7-0f2e12d2f406

📥 Commits

Reviewing files that changed from the base of the PR and between a2e5b26 and 6110886.

📒 Files selected for processing (26)
  • docs/src/web/content/deploy-operate/deploy-framework-apps.mdx
  • docs/src/web/content/deploy-operate/environment-variables.mdx
  • docs/src/web/content/deploy-operate/index.mdx
  • docs/src/web/content/get-started/app-configuration.mdx
  • docs/src/web/content/reference/cli/configuration.mdx
  • docs/src/web/content/reference/cli/deployment.mdx
  • docs/src/web/content/reference/cli/profiles.mdx
  • packages/cli/src/cli.ts
  • packages/cli/src/cmd/cloud/deploy.ts
  • packages/cli/src/cmd/cloud/deploy/register.ts
  • packages/cli/src/cmd/cloud/env/push.ts
  • packages/cli/src/cmd/project/add/domain.ts
  • packages/cli/src/cmd/project/domain/check.ts
  • packages/cli/src/cmd/project/reconcile.ts
  • packages/cli/src/config.ts
  • packages/cli/src/env-util.ts
  • packages/cli/src/main.ts
  • packages/cli/src/types.ts
  • packages/cli/test/config/env-files.test.ts
  • packages/cli/test/config/project-config-path.test.ts
  • packages/skills/skills/agentuity-cli/SKILL.md
  • packages/skills/skills/agentuity-cloud/SKILL.md
  • packages/skills/skills/agentuity-project/SKILL.md
  • skills/agentuity-cli/SKILL.md
  • skills/agentuity-cloud/SKILL.md
  • skills/agentuity-project/SKILL.md

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

📦 Canary Packages Published

version: 3.1.13-6110886

Packages
Package Version URL
@agentuity/schedule 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-schedule-3.1.13-6110886.tgz
@agentuity/runtime 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-runtime-3.1.13-6110886.tgz
@agentuity/queue 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-queue-3.1.13-6110886.tgz
@agentuity/pi 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-pi-3.1.13-6110886.tgz
@agentuity/migrate 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-migrate-3.1.13-6110886.tgz
@agentuity/analytics 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-analytics-3.1.13-6110886.tgz
@agentuity/coder-tui 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-coder-tui-3.1.13-6110886.tgz
@agentuity/genesis 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-genesis-3.1.13-6110886.tgz
@agentuity/email 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-email-3.1.13-6110886.tgz
@agentuity/core 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-core-3.1.13-6110886.tgz
@agentuity/client 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-client-3.1.13-6110886.tgz
create-agentuity 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/create-agentuity-3.1.13-6110886.tgz
@agentuity/sandbox 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-sandbox-3.1.13-6110886.tgz
@agentuity/skills 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-skills-3.1.13-6110886.tgz
@agentuity/coder 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-coder-3.1.13-6110886.tgz
@agentuity/config 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-config-3.1.13-6110886.tgz
@agentuity/vector 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-vector-3.1.13-6110886.tgz
@agentuity/api 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-api-3.1.13-6110886.tgz
@agentuity/drizzle 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-drizzle-3.1.13-6110886.tgz
@agentuity/cli 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-cli-3.1.13-6110886.tgz
@agentuity/vite 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-vite-3.1.13-6110886.tgz
@agentuity/db 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-db-3.1.13-6110886.tgz
@agentuity/webhook 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-webhook-3.1.13-6110886.tgz
@agentuity/aigateway 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-aigateway-3.1.13-6110886.tgz
@agentuity/storage 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-storage-3.1.13-6110886.tgz
@agentuity/hono 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-hono-3.1.13-6110886.tgz
@agentuity/opencode 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-opencode-3.1.13-6110886.tgz
@agentuity/server 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-server-3.1.13-6110886.tgz
@agentuity/stream 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-stream-3.1.13-6110886.tgz
@agentuity/adapter 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-adapter-3.1.13-6110886.tgz
@agentuity/schema 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-schema-3.1.13-6110886.tgz
@agentuity/telemetry 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-telemetry-3.1.13-6110886.tgz
@agentuity/postgres 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-postgres-3.1.13-6110886.tgz
@agentuity/claude-code 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-claude-code-3.1.13-6110886.tgz
@agentuity/keyvalue 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-keyvalue-3.1.13-6110886.tgz
@agentuity/task 3.1.13-6110886 https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-task-3.1.13-6110886.tgz
Install

Add to your package.json:

{
  "dependencies": {
    "@agentuity/schedule": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-schedule-3.1.13-6110886.tgz",
    "@agentuity/runtime": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-runtime-3.1.13-6110886.tgz",
    "@agentuity/queue": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-queue-3.1.13-6110886.tgz",
    "@agentuity/pi": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-pi-3.1.13-6110886.tgz",
    "@agentuity/migrate": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-migrate-3.1.13-6110886.tgz",
    "@agentuity/analytics": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-analytics-3.1.13-6110886.tgz",
    "@agentuity/coder-tui": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-coder-tui-3.1.13-6110886.tgz",
    "@agentuity/genesis": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-genesis-3.1.13-6110886.tgz",
    "@agentuity/email": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-email-3.1.13-6110886.tgz",
    "@agentuity/core": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-core-3.1.13-6110886.tgz",
    "@agentuity/client": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-client-3.1.13-6110886.tgz",
    "create-agentuity": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/create-agentuity-3.1.13-6110886.tgz",
    "@agentuity/sandbox": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-sandbox-3.1.13-6110886.tgz",
    "@agentuity/skills": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-skills-3.1.13-6110886.tgz",
    "@agentuity/coder": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-coder-3.1.13-6110886.tgz",
    "@agentuity/config": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-config-3.1.13-6110886.tgz",
    "@agentuity/vector": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-vector-3.1.13-6110886.tgz",
    "@agentuity/api": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-api-3.1.13-6110886.tgz",
    "@agentuity/drizzle": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-drizzle-3.1.13-6110886.tgz",
    "@agentuity/cli": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-cli-3.1.13-6110886.tgz",
    "@agentuity/vite": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-vite-3.1.13-6110886.tgz",
    "@agentuity/db": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-db-3.1.13-6110886.tgz",
    "@agentuity/webhook": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-webhook-3.1.13-6110886.tgz",
    "@agentuity/aigateway": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-aigateway-3.1.13-6110886.tgz",
    "@agentuity/storage": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-storage-3.1.13-6110886.tgz",
    "@agentuity/hono": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-hono-3.1.13-6110886.tgz",
    "@agentuity/opencode": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-opencode-3.1.13-6110886.tgz",
    "@agentuity/server": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-server-3.1.13-6110886.tgz",
    "@agentuity/stream": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-stream-3.1.13-6110886.tgz",
    "@agentuity/adapter": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-adapter-3.1.13-6110886.tgz",
    "@agentuity/schema": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-schema-3.1.13-6110886.tgz",
    "@agentuity/telemetry": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-telemetry-3.1.13-6110886.tgz",
    "@agentuity/postgres": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-postgres-3.1.13-6110886.tgz",
    "@agentuity/claude-code": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-claude-code-3.1.13-6110886.tgz",
    "@agentuity/keyvalue": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-keyvalue-3.1.13-6110886.tgz",
    "@agentuity/task": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-task-3.1.13-6110886.tgz"
  }
}

Or install directly:

bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-schedule-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-runtime-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-queue-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-pi-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-migrate-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-analytics-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-coder-tui-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-genesis-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-email-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-core-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-client-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/create-agentuity-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-sandbox-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-skills-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-coder-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-config-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-vector-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-api-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-drizzle-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-cli-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-vite-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-db-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-webhook-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-aigateway-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-storage-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-hono-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-opencode-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-server-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-stream-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-adapter-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-schema-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-telemetry-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-postgres-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-claude-code-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-keyvalue-3.1.13-6110886.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.13-6110886/agentuity-task-3.1.13-6110886.tgz

@jhaynie
jhaynie merged commit 7a2ec23 into main Jul 24, 2026
28 of 29 checks passed
@jhaynie
jhaynie deleted the feat/cli-project-config-and-env-flags branch July 24, 2026 01:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant