chore(merge): merge master

Author: DivyMohan14

.github/workflows/go-test.yml

@@ -33,3 +33,8 @@ jobs:
         uses: golangci/golangci-lint-action@4afd733a84b1f43292c63897423277bb7f4313a9 # v8.0.0
         with:
           version: v2.1
+
+      - name: Check for unstaged changes
+        run: |
+          make gen
+          ./check_unstaged.sh

.github/workflows/release.yml

@@ -33,6 +33,11 @@ jobs:
     - name: Install Chat Dependencies
       run: cd chat && bun install
 
+    - name: Run make gen and check for unstaged changes
+      run: |
+        make gen
+        ./check_unstaged.sh
+
     - name: Build and Upload
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

AGENTS.md

@@ -0,0 +1,85 @@
+# AGENTS.md
+
+This file provides guidance to AI agents working with code in this repository.
+
+## Build Commands
+
+- `make build` - Build the binary to `out/agentapi` (includes chat UI build)
+- `make embed` - Build the chat UI and embed it into Go
+- `go build -o out/agentapi main.go` - Direct Go build without chat UI
+- `go generate ./...` - Generate OpenAPI schema and version info
+
+## Testing
+
+- `go test ./...` - Run all Go tests
+- Tests are located alongside source files (e.g., `lib/httpapi/server_test.go`)
+
+## Development Commands
+
+- `agentapi server -- claude` - Start server with Claude Code agent
+- `agentapi server -- aider --model sonnet` - Start server with Aider agent
+- `agentapi server -- goose` - Start server with Goose agent
+- `agentapi server --type=codex -- codex` - Start server with Codex (requires explicit type)
+- `agentapi server --type=gemini -- gemini` - Start server with Gemini (requires explicit type)
+- `agentapi attach --url localhost:3284` - Attach to running agent terminal
+- Server runs on port 3284 by default
+- Chat UI available at http://localhost:3284/chat
+- API documentation at http://localhost:3284/docs
+
+## Architecture
+
+This is a Go HTTP API server that controls coding agents (Claude Code, Aider, Goose, etc.) through terminal emulation.
+
+**Core Components:**
+- `main.go` - Entry point using cobra CLI framework
+- `cmd/` - CLI command definitions (server, attach)
+- `lib/httpapi/` - HTTP server, routes, and OpenAPI schema
+- `lib/screentracker/` - Terminal output parsing and message splitting
+- `lib/termexec/` - Terminal process execution and management
+- `lib/msgfmt/` - Message formatting for different agent types (claude, goose, aider, codex, gemini, amp, cursor-agent, cursor, auggie, custom)
+- `chat/` - Next.js web UI (embedded into Go binary)
+
+**Key Architecture:**
+- Runs agents in an in-memory terminal emulator
+- Translates API calls to terminal keystrokes
+- Parses terminal output into structured messages
+- Supports multiple agent types with different message formats
+- Embeds Next.js chat UI as static assets in Go binary
+
+**Message Flow:**
+1. User sends message via HTTP API
+2. Server takes terminal snapshot
+3. Message sent to agent as terminal input
+4. Terminal output changes tracked and parsed
+5. New content becomes agent response message
+6. SSE events stream updates to clients
+
+## API Endpoints
+
+- GET `/messages` - Get all messages in conversation
+- POST `/message` - Send message to agent (content, type fields)
+- GET `/status` - Get agent status ("stable" or "running")
+- GET `/events` - SSE stream of agent events
+- GET `/openapi.json` - OpenAPI schema
+- GET `/docs` - API documentation UI
+- GET `/chat` - Web chat interface
+
+## Supported Agents
+
+Agents with explicit type requirement (use `--type=<agent>`):
+- `codex` - OpenAI Codex
+- `gemini` - Google Gemini CLI
+- `amp` - Sourcegraph Amp CLI
+- `cursor` - Cursor CLI
+
+Agents with auto-detection:
+- `claude` - Claude Code (default)
+- `goose` - Goose
+- `aider` - Aider
+
+## Project Structure
+
+- Go module with standard layout
+- Chat UI in `chat/` directory (Next.js + TypeScript)
+- OpenAPI schema auto-generated to `openapi.json`
+- Version managed via `version.sh` script

CHANGELOG.md

@@ -1,6 +1,22 @@
 # Changelog
 
-## 0.6.1
+## v0.7.0
+
+### Features
+- Add Support for Opencode.
+- Add support for Agent aliases
+- Explicitly support AmazonQ
+- Bump NEXT.JS version
+
+## v0.6.3
+
+- CI fixes.
+
+## v0.6.2
+
+- Fix incorrect version string.
+
+## v0.6.1
 
 ### Features
 - Handle animation on Amp cli start screen.

MAINTAINERS.md

@@ -5,27 +5,14 @@
 Before performing a release, perform a local "smoke-test".
 If everything seems OK, you can proceed to do the following:
 
-1. Update the version string in the following places:
-   - `openapi.json`
-   - `chat/package.json`
-   - `lib/httpapi/server.go`
+1. Update the version string in `internal/version/version.go` and run `make gen`.
 2. Add details in `CHANGELOG.md` on what changed.
 3. Create a PR with the subject `chore: update version to X.Y.Z`
-4. Once the above PR is approved and merged, create a new git tag `vX.Y.Z` pointing to the commit of the above PR merged to `main`:S
+4. Once the above PR is approved and merged, update your local branch and run `release.sh`.
+   If the script reports errors, fix them before continuing.
+   If there are no issues, it will output the Github tag URL.
 
-   ```shell
-     # Fetch existing tags first!
-     git fetch --tags
-     git tag -a vX.Y.Z -m 'vX.Y.Z'
-   ```
-
-5. Push the tag:
-
-   ```shell
-      git push origin tag vX.Y.Z
-   ```
-
-6. Visit `https://github.com/coder/agentapi/releases/tag/vX.Y.Z` and "Create release from tag".
+5. Visit `https://github.com/coder/agentapi/releases/tag/vX.Y.Z` and "Create release from tag".
 
    - Select the tag you pushed previously.
    - Select the previous tag and "Generate release notes". Amend as required.

Makefile

@@ -18,3 +18,7 @@ embed: $(CHAT_SOURCES_STAMP)
 .PHONY: build
 build: embed
 	CGO_ENABLED=0 go build -o ${BINPATH} main.go
+
+.PHONY: gen
+gen:
+	go generate ./...

README.md

@@ -1,6 +1,6 @@
 # AgentAPI
 
-Control [Claude Code](https://github.com/anthropics/claude-code), [Goose](https://github.com/block/goose), [Aider](https://github.com/Aider-AI/aider), [Gemini](https://github.com/google-gemini/gemini-cli), [Sourcegraph Amp](https://github.com/sourcegraph/amp-cli), [Codex](https://github.com/openai/codex), [Auggie](https://docs.augmentcode.com/cli/overview), and [Cursor CLI](https://cursor.com/en/cli) with an HTTP API.
+Control [Claude Code](https://github.com/anthropics/claude-code), [AmazonQ](https://aws.amazon.com/developer/learning/q-developer-cli/), [Opencode](https://opencode.ai/), [Goose](https://github.com/block/goose), [Aider](https://github.com/Aider-AI/aider), [Gemini](https://github.com/google-gemini/gemini-cli), [Sourcegraph Amp](https://github.com/sourcegraph/amp-cli), [Codex](https://github.com/openai/codex), [Auggie](https://docs.augmentcode.com/cli/overview), and [Cursor CLI](https://cursor.com/en/cli) with an HTTP API.
 
 ![agentapi-chat](https://github.com/user-attachments/assets/57032c9f-4146-4b66-b219-09e38ab7690d)
 
@@ -65,7 +65,7 @@ agentapi server -- goose
 ```
 
 > [!NOTE]
-> When using Codex, Gemini, Amp or CursorCLI, always specify the agent type explicitly (eg: `agentapi server --type=codex -- codex`), or message formatting may break.
+> When using Codex, Opencode, Gemini, Amp or CursorCLI, always specify the agent type explicitly (eg: `agentapi server --type=codex -- codex`), or message formatting may break.
 
 An OpenAPI schema is available in [openapi.json](openapi.json).