Release/v0.2.0#4
Merged
digitallysavvy merged 26 commits intomainfrom May 5, 2026
Merged
Conversation
Default new projects to rtc, rtm, and convoai (convoai implies rtm) on init and project create, with --rtm-data-center (CN/NA/EU/AP, default NA). Refine agora init when neither --project nor --new-project is set: bind to an exact "Default Project" when present; otherwise in interactive sessions offer create-new plus existing projects oldest-to-newest with the newest as the default, while JSON/CI/non-TTY reuse still picks the most recent project. Empty accounts still create a project. Update docs (automation, generated commands), CHANGELOG [Unreleased], and integration/unit tests.
Infer Next.js vs standard credential env keys, add --template override, resolve merge conflicts with legacy keys, and create or update .agora/project.json with projectType and envPath after writes. Align quickstart bindings on a single template field. Document JSON output, detection rules, and PROJECT_ENV_TEMPLATE_UNKNOWN.
Honor explicit --project/--new-project, auto-bind "Default Project" when present, and present an interactive list ordered for create-new first and newest projects last. Update the introspect golden for the global --yes flag.
Open the auth URL safely on Windows, listen on IPv4 and IPv6 loopback for the OAuth callback, emit compact progress on TTY stderr outside JSON mode, and truncate wide pretty-printed values. Clarify global --yes semantics and refresh the introspect golden file.
…tall Publish optional platform tarballs as agoraio-cli-* instead of @agoraio/cli-*, update the release workflow paths, and teach install.sh --uninstall to remove the managed binary and agora.install.json while keeping config under AGORA_HOME.
Expose the CLI as an MCP stdio server, centralize rtc/rtm/convoai in features.go for validation and introspect enums, derive init defaults from that catalog, infer AGORA_USER_AGENT labels from common agent env markers, and add init --add-agent-rules with managed snippets for Cursor, Claude, and Windsurf. Document MCP usage, agent docs layout, and refresh README/AGENTS.
Add AGORA_HOME/cache projects list with TTL and tests; serve completion from cache when the session is valid, clear cache on logout, and prune stale cache on startup. Add project list --refresh-cache and cacheRefreshed in JSON. Refactor agora open through open_targets (docs-md, env URL overrides). Derive feature flag help text from featureListString() and add catalog tests.
Use golang.org/x/term (with COLUMNS override) so printBlock can truncate long values sensibly when stderr/stdout exposes a size. Document why pretty progress stays line-based instead of a spinner. Bump the module to Go 1.26.2 and add render tests.
Document new behavior in automation and commands references, refresh install and releasing notes, align the issue template and PowerShell installer examples with v0.2.0, and update the version.go ldflags comment.
Publish docs on push to main, run govulncheck on a schedule and PRs, enable dependabot for Go and Actions, and record default code owners.
Introduce prepare-pages-site.py to expand @@CLI_DOCS_*@@ placeholders in the built site, mirror Markdown under /md/, and emit docs.env. Point docs index links at tokens, document the contract in automation.md, extend the changelog, and lock open-target URLs to site.env via tests.
…ont matter Ship a default layout and site CSS for GitHub Pages, exclude site.env from the Jekyll build, add make docs-preview via preview-pages-site.sh + URL prep, emit YAML front matter from docgen for the command reference, align Markdown docs with the layout, ignore _local _site output, and record the change in the changelog.
Keep install commands on the GitHub raw installer across index and llms, document open/mcp/completion and project metadata in README, refresh AGENTS layout and release/tag notes, and match CONTRIBUTING to CHANGELOG [Unreleased] plus docs-preview and automation cross-links.
Align CONTRIBUTING’s release example, CHANGELOG heading and header note, version.go ldflags comment, and bug report placeholder with the May 1 ship date.
Introduce top-level agora doctor for local install diagnostics, agora env-help for the env catalog, and agora skills for curated agent recipes; split telemetry behind a small client interface, refresh installers and installer message tests in CI, expand docs (troubleshooting, schema, proposals), and add SECURITY and SUPPORT policies.
Drop the README migration blurb and TS-oriented copy from AGENTS, skills, and telemetry comments. Rewrite the Sentry proposal context without referencing another codebase. Rename integration tests that used a "Parity" suffix for clearer intent.
Use agora-cli in the cli package doc comment and the bug report version placeholder so issue filings match released binary branding.
Add devex-backlog.md with P0/P1/P2 items, target paths, and acceptance criteria for follow-up work.
digitallysavvy
added
documentation
…ibility Use golangci/golangci-lint-action install-mode goinstall so the linter matches go.mod. Document go install for local lint setups.
…sign) Ignore RegisterFlagCompletionFunc errors like other commands; drop unused projectCredentialEnvValues wrapper; call redactTelemetryFields from noop telemetry sinks; use errors.As in agent_infer test helper; fix separator init in agent rule append path.
Postpone the documented ship date to Monday; update examples in CONTRIBUTING, bug report template, and version.go ldflags comment.
Fix CI: gofmt drift on internal/cli/telemetry.go and refresh the command reference so gendocs -check matches the live cobra tree.
…ess is default and only option
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This release is documented in
CHANGELOG.mdunder[0.2.0] - 2026-05-01. It expands agent and automation support, refreshes documentation and install UX, and includes a few documented breaking changes (global--verbose, installer flags, npm scoped package layout).Highlights
docs/schema/envelope.v1.json),agora introspect/ help JSON,init --add-agent-rules,AGORA_AGENTinference, project completion cache, andllms.txtupdates.agora doctor(install self-test),agora env-help,agora skills,agora self-updatealias,--debugas the single log-echo flag, Cobra typo suggestions,--format envelope|jsonforproject env.project env writeand.agora/project.jsonfields./md/mirror,make docs-preview,SECURITY.md,SUPPORT.md,docs/troubleshooting.md, contributor and issue-template updates.govulncheck, Dependabot, CODEOWNERS, telemetry interface stub and Sentry wire-up proposal.docs/devex-backlog.mdfor prioritized DevEx work; copy and comment cleanup (legacy references,agora-clinaming in package comment and bug template).Breaking changes
Call these out in the merge or release notes; full text and migration notes are in CHANGELOG under Removed and Changed:
--verbose/-vandAGORA_VERBOSEin favor of--debug/AGORA_DEBUG(config auto-migratesverbose→debugon first load).--add-to-path/-AddToPathand--completion …; replaced by default-on shell setup and--no-path,--no-completion,--skip-shell(and PowerShell equivalents).agoraio-cli-*names instead of@agoraio/cli-*.Testing
go test -count=1 ./...make lint(or CI green on this branch)agora --version,agora doctor --json,agora introspect --jsonscripts/test-installer-messages.sh/ documented manual install paths as appropriate