Add a local Developer Web UI (`agentcore web`)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 30/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- fastapi, typescript
- 領域
- backend, cli, documentation, frontend, observability
調査の方向性
まず既存の agentcore dev と agentcore invoke コマンドのエントリポイントを読み、次に issue で言及されている動作するプロトタイプを確認します。提案されている agentcore web コマンド、FastAPI/SSE サーバー、ブラウザワークスペース、セッション処理、エージェント検出を受け入れ条件と照合します。コマンドがローカルで起動し、一覧にある UI、ストリーミング、メトリクス、エラー処理、ドキュメントの動作がカバーされていれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Summary
Add a local, browser-based Developer Web UI to the AgentCore CLI — a visual counterpart to agentcore dev, similar in spirit to the Google ADK adk web developer UI. It would let developers chat with any agent in their project, hold multiple persistent sessions, and watch tool calls, sub-agent delegation, reasoning, token usage and cost stream live in the browser — no deployment required.
Today the fastest way to exercise an agent locally is the terminal (agentcore dev / agentcore invoke). That's great for quick checks, but it's hard to inspect how a multi-tool, multi-agent run actually behaved: which tools were called, in what order, with what inputs/outputs, which ones failed, and what it cost. A browser UI makes that inspectable at a glance.
Motivation
- Faster local iteration — pick an agent, chat, and re-run without wiring up scripts.
- Observability while developing — see the live tool log and a per-response trace instead of scrolling raw stdout.
- Debuggability — failed tool calls (timeouts, bad SQL, missing columns) are visible with their exact input/output.
- Cost/perf awareness — latency, in/out tokens, cycles, tool-call count, model id and estimated cost per response.
- Parity with other agent frameworks — developers coming from Google ADK expect a
webdev surface.
Proposed capabilities
A new agentcore web command launches a FastAPI + SSE server on localhost (default port 8502) and opens the browser. Reuses the same local credential resolution as agentcore dev.
Three-pane workspace:

- Left — Agents & Sessions: agent picker, plus create/switch/delete of independent chat sessions (each keeps its own history), and a "Clear Agent Cache" action to reload agent code from disk after local edits.
- Center — Chat & live log: the conversation, with a live tool-call log that expands while a response streams and a "Copy logs" action for bug reports.
- Right — Trace & Metrics: per-response latency, cost, in/out tokens, cycles, tool-call count, model id, and an expandable ordered tool trace.
Agent selection — every agent in the project (including sub-agents) is selectable:

Live tool logs — each call shows a status icon (success / warning / error) and elapsed time, so failures are obvious mid-run:

Trace inspection — expand any tool call to see its JSON input/output; SQL-backed tools render the exact SQL that ran:
| Input & output | SQL executed |
|---|---|
![]() |
![]() |
Scope / non-goals
- Local development aid only — binds to
localhost, deploys nothing, and changes no AWS resources beyond invoking the developer's own agents. - Not a production or hosted dashboard.
Acceptance criteria
-
agentcore web [--port <n>]starts the UI, auto-selecting a free port if the default is busy, and opens the browser. - Agents (and sub-agents) in the project are discoverable and selectable.
- Multiple persistent sessions per agent (create / switch / delete).
- Live streaming of text, tool calls, and reasoning via SSE.
- Per-response trace + metrics (latency, tokens, cycles, tool calls, cost, model).
- Graceful error surfaces when
uvicornis missing. - Docs page describing the feature with screenshots.
Happy to contribute the implementation (a working prototype exists on a branch).
- 主要言語
- TypeScript
- スター
- 291
- フォーク
- 96
- 平均マージ
- 20時間 50分
- マージ済み PR(30日)
- 214
環境構築
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
aws/agentcore-cli のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
aws/agentcore-cli#2395 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
aws/agentcore-cli#2392 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
aws/agentcore-cli#2267 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
aws/agentcore-cli#2258 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
aws/agentcore-cli#2176 ·
メンテナーはふだん 1 日以内に返信
aws/agentcore-cli の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
diegosouzapw/OmniRoute#14869 ·
メンテナーはふだん 1 日以内に返信
-
enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 94/100
メンテナーはふだん 1 日以内に返信
-
status: waiting triage
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
freeCodeCamp/freeCodeCamp#70412 ·
メンテナーはふだん 1 日以内に返信
-
Mend: dependency security vulnerability untriaged
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
opensearch-project/OpenSearch-Dashboards#12816 ·
メンテナーはふだん 1 日以内に返信

