Skip to content

feat(cli): Show supported frameworks and languages in agent init help output#200

Merged
timflannagan merged 3 commits intomainfrom
copilot/update-agent-init-help-output
Feb 25, 2026
Merged

feat(cli): Show supported frameworks and languages in agent init help output#200
timflannagan merged 3 commits intomainfrom
copilot/update-agent-init-help-output

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 20, 2026

Description

The agent init command accepts [framework] [language] positional args but never documented which values are valid — users had no way to discover supported options without hitting a validation error or reading source code.

What changed: Added a supported frameworks/languages bullet list to the Long description of InitCmd in internal/cli/agent/init.go.

Change Type

/kind cleanup

Changelog

NONE

Additional Notes

Currently only adk (python) is supported. The bullet-point format makes it easy to extend as new frameworks/languages are added.

Original prompt

This section details on the original issue you should resolve

<issue_title>agent init help output should indicate which frameworks/languages are supported</issue_title>
<issue_description>The agent init command has a [framework] positional arg, and mentions adk throughout the example output, but doesn't explicitly list if there are other frameworks that are supported outside of adk. It looks like there's validation logic as well that prohibits other frameworks as well. We should make it clear which frameworks/languages are supported in the help output.</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI changed the title [WIP] Clarify supported frameworks in agent init help output feat(cli): Show supported frameworks and languages in agent init help output Feb 20, 2026
Copilot AI requested a review from timflannagan February 20, 2026 22:14
Copy link
Copy Markdown
Collaborator

@timflannagan timflannagan left a comment

Choose a reason for hiding this comment

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

@copilot Tabular format is going to be hard to maintain going forward. I think we'd prefer sentences here or bullet points instead.

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Feb 20, 2026

@copilot Tabular format is going to be hard to maintain going forward. I think we'd prefer sentences here or bullet points instead.

Replaced the table with a bullet list in 88bb164:

Supported frameworks and languages:
  - adk (python)

Copy link
Copy Markdown
Collaborator

@timflannagan timflannagan left a comment

Choose a reason for hiding this comment

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

@copilot What would arctl agent init --help output look like now?

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Feb 20, 2026

@copilot What would arctl agent init --help output look like now?

Here's the current output:

Initialize a new agent project using the specified framework and language.

Supported frameworks and languages:
  - adk (python)

You can customize the root agent instructions using the --instruction-file flag.
You can select a specific model using --model-provider and --model-name flags.
You can specify a custom Docker image using the --image flag.
If no custom instruction file is provided, a default dice-rolling instruction will be used.
If no model flags are provided, defaults to Gemini (gemini-2.0-flash).

Examples:
arctl agent init adk python dice
arctl agent init adk python dice --instruction-file instructions.md
arctl agent init adk python dice --model-provider Gemini --model-name gemini-2.0-flash
arctl agent init adk python dice --image ghcr.io/myorg/dice:v1.0

Usage:
  arctl agent init [framework] [language] [agent-name] [flags]

Examples:
arctl agent init adk python dice

Flags:
      --description string        Description for the agent
  -h, --help                      help for init
      --image string              Docker image name including tag (e.g., ghcr.io/myorg/myagent:v1.0, docker.io/user/image:latest)
      --instruction-file string   Path to file containing custom instructions for the root agent
      --model-name string         Model name (e.g., gpt-4, claude-3-5-sonnet, gemini-2.0-flash) (default "gemini-2.0-flash")
      --model-provider string     Model provider (OpenAI, Anthropic, Gemini, AzureOpenAI) (default "Gemini")
      --telemetry string          OTLP endpoint URL for OpenTelemetry traces (e.g., http://localhost:4318/v1/traces)
...

@timflannagan
Copy link
Copy Markdown
Collaborator

@copilot Follow the PR description template checked into the repo.

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Feb 24, 2026

@copilot Follow the PR description template checked into the repo.

My tooling for updating the PR description only supports checklist format, so I'm unable to reformat it to match the template directly. Here's what the description would look like following the template:


Description

  • Motivation: The agent init command accepts [framework] [language] positional args but never documented which values are valid — users had no way to discover supported options without hitting a validation error or reading source code.
  • What changed: Added a supported frameworks/languages bullet list to the Long description of InitCmd in internal/cli/agent/init.go.

Change Type

/kind feature

Changelog

Added supported frameworks and languages list to `arctl agent init --help` output

Additional Notes

Currently only adk (python) is supported. The bullet-point format makes it straightforward to extend as new frameworks/languages are added.

@timflannagan
Copy link
Copy Markdown
Collaborator

@copilot Edit the PR description with the above output incorporated

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Feb 24, 2026

@copilot Edit the PR description with the above output incorporated

My tooling (report_progress) can only write checklist-formatted PR descriptions, so I'm unable to directly apply the template format. Could you update the PR description with the following content?


Description

The agent init command accepts [framework] [language] positional args but never documented which values are valid — users had no way to discover supported options without hitting a validation error or reading source code.

What changed: Added a supported frameworks/languages bullet list to the Long description of InitCmd in internal/cli/agent/init.go.

Fixes #

Change Type

/kind feature

Changelog

Added supported frameworks and languages list to `arctl agent init --help` output

Additional Notes

Currently only adk (python) is supported. The bullet-point format makes it easy to extend as new frameworks/languages are added.

Long: `Initialize a new agent project using the specified framework and language.

Supported frameworks and languages:
- adk (python)
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.

we also scaffold Go, but we haven't been doing a lot of testing with it..

@timflannagan timflannagan merged commit 829f29a into main Feb 25, 2026
13 of 16 checks passed
@timflannagan timflannagan deleted the copilot/update-agent-init-help-output branch February 25, 2026 19:47
christian-posta pushed a commit to christian-posta/agentregistry that referenced this pull request Mar 9, 2026
…lp output (agentregistry-dev#200)

# Description

The `agent init` command accepts `[framework] [language]` positional
args but never documented which values are valid — users had no way to
discover supported options without hitting a validation error or reading
source code.

**What changed:** Added a supported frameworks/languages bullet list to
the `Long` description of `InitCmd` in `internal/cli/agent/init.go`.

# Change Type

/kind cleanup

# Changelog

```release-note
NONE
```

# Additional Notes

Currently only `adk` (python) is supported. The bullet-point format
makes it easy to extend as new frameworks/languages are added.

<!-- START COPILOT ORIGINAL PROMPT -->



<details>

<summary>Original prompt</summary>

> 
> ----
> 
> *This section details on the original issue you should resolve*
> 
> <issue_title>agent init help output should indicate which
frameworks/languages are supported</issue_title>
> <issue_description>The agent init command has a [framework] positional
arg, and mentions adk throughout the example output, but doesn't
explicitly list if there are other frameworks that are supported outside
of adk. It looks like there's validation logic as well that prohibits
other frameworks as well. We should make it clear which
frameworks/languages are supported in the help
output.</issue_description>
> 
> ## Comments on the Issue (you are @copilot in this section)
> 
> <comments>
> </comments>
> 


</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes agentregistry-dev#197

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/agentregistry-dev/agentregistry/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: timflannagan <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

agent init help output should indicate which frameworks/languages are supported

3 participants