a2aproject / a2aproject/a2a-cli

feat: rename `card get` to `card inspect`

Open
#15 2 comments 1 reaction 0 assignees View on GitHub
enhancement
Dominant language
Go
Stars
95
Forks
4
Avg merge
3d 2h
Merged PRs (30d)
24

Description

## Problem

`card get` is misleading — the verb "get" implies a remote fetch, but the command works equally well with local `file://...` references where nothing is "gotten". The command's real purpose is **displaying/inspecting the contents of an agent card**, regardless of where it lives.

## Proposal

Rename `card get` to `card inspect` (preferred) or `card show`.

**Why `inspect`:**
- Matches the mental model — you are inspecting a card's contents
- Consistent with other CLI tooling conventions (`docker inspect`, `kubectl describe`)
- Works equally well for remote URLs and local `file://` references
- Avoids confusion with "fetching" or "downloading"

## Implementation notes

- Rename the command in `internal/cli/card_get.go` (and the file itself)
- Update `card.go` subcommand registration
- Add a deprecated `get` alias pointing to `inspect` for backwards compatibility
- Update README / docs

## References

- `internal/cli/card_get.go` — command implementation
- `internal/cli/card.go` — parent command registration

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.