Skip to content

docs: adk branch create --env flag to specify source env for new branch#57

Merged
AaronForinton merged 5 commits intomainfrom
docs/auto-update-e9dd3b9
Apr 14, 2026
Merged

docs: adk branch create --env flag to specify source env for new branch#57
AaronForinton merged 5 commits intomainfrom
docs/auto-update-e9dd3b9

Conversation

@AaronForinton
Copy link
Copy Markdown
Contributor

@AaronForinton AaronForinton commented Apr 1, 2026

Summary

This PR is related to #56

Motivation

Closes #

Changes

Test strategy

  • Added/updated unit tests
  • Manual CLI testing (poly <command>)
  • Tested against a live Agent Studio project
  • N/A (docs, config, or trivial change)

Checklist

  • ruff check . and ruff format --check . pass
  • pytest passes
  • No breaking changes to the poly CLI interface (or migration path documented)
  • Commit messages follow conventional commits

Screenshots / Logs

@AaronForinton AaronForinton changed the title docs: auto-update from e9dd3b9 docs: adk branch create --env flag to specify source env for new branch Apr 1, 2026

| Flag | Description |
|---|---|
| `--env`, `--environment` | Source the new branch from a deployment snapshot instead of sandbox main. Choices: `sandbox`, `pre-release`, `live`. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yuenhsi @jsanter27

Is snapshot a good concept here, or better to just refer to
'current state of deployment environment'?

Also can we talk about 'commiting' changes or is this too potentially confused with git commits?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah agreed.
Source the new branch from the current state of a deployed environment
Force branch creation and discard local changes

Comment thread docs/docs/reference/cli.md Outdated
@AaronForinton AaronForinton requested a review from yuenhsi April 1, 2026 13:10
Copy link
Copy Markdown
Contributor

@yuenhsi yuenhsi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving to unblock, but note that generating an API key in agent studio is no longer under the Data Access tab.

Please update this before merging!

Comment thread docs/docs/reference/cli.md Outdated
Comment thread docs/docs/reference/cli.md
@AaronForinton AaronForinton force-pushed the docs/auto-update-e9dd3b9 branch from 7eb25c6 to 941b968 Compare April 14, 2026 15:24
@AaronForinton AaronForinton merged commit 2de96af into main Apr 14, 2026
3 checks passed
@AaronForinton AaronForinton deleted the docs/auto-update-e9dd3b9 branch April 14, 2026 15:29
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.

4 participants