aws / aws/agentcore-cli

Support changing port and base path of dev chat UI

Open
#1,685 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
TypeScript
Stars
283
Forks
95
Avg merge
1d 2h
Merged PRs (30d)
183

Description

### Description

My goal is to use the `agentcore dev` UI in a cloud IDE like VS Code Server or possibly SageMaker Studio. In these contexts:
1. There are often restrictions to which ports can be used (since typically the IDE itself is running on one, and a web proxy like nginx on another), and
2. Forwarded ports are typically accessed via some non-base path e.g. `https://...cloudfront.net/port/9000/`

Both of these pose problems for the AgentCore CLI today:
1. Currently, the `--port` option in `agentcore dev` does not set the port of the web UI that's spun up... In fact in my specific environment, it didn't seem to correspond to the agent server that's started either? So it's counter-intuitive at best and maybe pointless at worst. It always seems to use `8081`.
2. The web UI also assumes it's running at the root `/` with no way to configure this... So first assets (like `/index.js`) and later API calls (like `/api/status`) try to pull from the "wrong" URL when used in this environment.
3. The web UI also seems to check request host headers and reject any connections that don't come from 127.0.0.1/localhost - which further complicates things

I did manage to get the current app working with some creative nginx configuration - but it's pretty messy, especially number 2 that requires a broad range of `sub_filter`s manipulating inbound requests. It'd be much better if the CLI itself could provide more direct support for running in this kind of remote IDE environment.

### Acceptance Criteria

The dev chat web UI:
- [ ] Can be overridden to launch on a different port
- [ ] Can be configured with a "base path" prefix for all resource & API fetches (for e.g. `/port/9000/`)
- [ ] Can disable checks on `Host`, `Origin`, `X-Agentcore-Local` headers

Even better if:
- [ ] We can configure these options somewhere central they'll be transparently picked up without needing to be included in every `agentcore dev` command - or even auto-detect when running in such an environment

### Additional Context

_No response_

Contributor guide

Open the contributing guide

Research direction

Start at the `agentcore dev` entry point and trace how `--port` launches the agent server and dev chat web UI. Inspect the UI handling of `/index.js`, `/api/status`, and Host, Origin, and X-Agentcore-Local headers. Done means the UI supports a configurable port, base path, and optional header checks, with the behavior covered by the repository's relevant tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
cli, frontend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.