Add local uvx mode to Serena tool with HTTP transport #10073

Copilot · 2026-01-15T13:28:00Z

Plan: Add Local uvx Mode to Serena Tool

Original prompt

Add an option tool the serena tool to run using uvx instead of docker and mount a http transport so that it runs locally in the action job (add a step to start Serena MCP at fixed port)

The runtime manager should register uvx and all the required setup-* to support this scenario.

Update smoke-copilot with testing local serena for go.

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

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2026-01-15T13:50:30Z

@copilot when in local mode, register setup languages with runtime manager

pelikhan · 2026-01-15T14:01:35Z

pkg/workflow/mcp_renderer.go

+		// Local mode: use HTTP transport
+		yaml.WriteString("          type = \"http\"\n")
+		yaml.WriteString("          url = \"http://localhost:$GH_AW_SERENA_PORT\"\n")
+		yaml.WriteString("          headers = { Authorization = \"$GH_AW_SERENA_API_KEY\" }\n")


@copilot api key not needed for serena

Done in 8a42c68. Removed API key generation and Authorization header from Serena MCP configuration. The HTTP server now runs without authentication.

pelikhan · 2026-01-15T14:02:07Z

pkg/workflow/mcp_servers.go

+// generateSerenaLocalModeSteps generates steps to start Serena MCP server locally using uvx
+func generateSerenaLocalModeSteps(yaml *strings.Builder) {
+	// Step 1: Generate API key and choose port for Serena HTTP server
+	yaml.WriteString("      - name: Generate Serena MCP Server Config\n")


@copilot refactor as shell script in actions/setup/sh

Done in 8a42c68. Refactored inline bash script to actions/setup/sh/start_serena_server.sh with proper error handling and health checks. The workflow now calls bash /opt/gh-aw/actions/start_serena_server.sh instead of inline code.

When Serena runs in local mode with uvx, language services need to be installed on the host machine. This change adds detectSerenaLanguageRuntimes() to automatically detect and register language runtimes (Go, Node, Python, Java, .NET) based on the configured languages in the Serena tool. Maps Serena language names to runtime IDs: - go -> go - typescript/javascript -> node - python -> python - java -> java - csharp -> dotnet Supports both short syntax (serena: ["go"]) and detailed configuration with versions. Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-01-15T14:03:41Z

@copilot when in local mode, register setup languages with runtime manager

Done in ea29d7c. Added detectSerenaLanguageRuntimes() to automatically register language runtimes (Go, Node, Python, Java, .NET) based on Serena's configured languages when running in local mode. The smoke-copilot workflow now includes Setup Go step before Setup uv.

- Removed API key generation and Authorization header for Serena MCP (not needed) - Refactored inline bash script to actions/setup/sh/start_serena_server.sh - Updated collectMCPEnvironmentVariables to only pass SERENA_PORT - Simplified generateSerenaLocalModeSteps to call the shell script - Created start_serena_server.sh with proper error handling and health checks Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

github-actions · 2026-01-15T14:44:20Z

✨ The prophecy is fulfilled... Smoke Codex has completed its mystical journey. The stars align. 🌟

pelikhan · 2026-01-15T14:44:21Z

@copilot local mode is an error in strict compilation mode

github-actions · 2026-01-15T14:44:22Z

🎬 THE END — Smoke Claude MISSION: ACCOMPLISHED! The hero saves the day! ✨

github-actions · 2026-01-15T14:44:22Z

📰 DEVELOPING STORY: Smoke Copilot reports failed. Our correspondents are investigating the incident...

github-actions · 2026-01-15T14:44:24Z

🎉 Yo ho ho! Changeset Generator found the treasure and completed successfully! ⚓💰

github-actions · 2026-01-15T14:47:30Z

Smoke Test Results

Last 2 merged PRs:

Remove ai-inference, opencode, genaiscript agentic engines for now #10 Remove ai-inference, opencode, genaiscript agentic engines for now
Add workflow: githubnext/agentics/weekly-research #8 Add workflow: githubnext/agentics/weekly-research

Test Results:

✅ GitHub MCP
✅ Serena Go (v0.1.4)
✅ Playwright (GitHub title confirmed)
✅ Tavily Web Search (5 results)
✅ File Write
✅ Bash Tool

Status: PASS

AI generated by Smoke Claude

In strict mode, Serena local mode is not allowed because it runs the MCP server directly on the host without containerization, bypassing security isolation. This change adds validateStrictTools() to check for serena with mode: local and reject it in strict mode. Changes: - Added validateStrictTools() to strict_mode_validation.go - Updated validateStrictMode() to call validateStrictTools() - Changed smoke-copilot.md to use default docker mode (removed mode: local) - Added comprehensive tests in strict_mode_serena_test.go The validation provides a clear error message directing users to use docker mode for security. Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-01-15T14:54:19Z

@copilot local mode is an error in strict compilation mode

Done in 809b07c. Added strict mode validation to prevent Serena local mode. In strict mode, local mode is rejected because it runs without containerization, bypassing security isolation. The smoke-copilot workflow now uses default docker mode, and comprehensive tests ensure the validation works correctly.

pelikhan · 2026-01-15T15:08:22Z

@copilot make sure the conclusion job "needs" the "agent" job

Copilot · 2026-01-15T15:15:21Z

@copilot make sure the conclusion job "needs" the "agent" job

The conclusion job already correctly depends on the agent job. The needs array is set at line 311 in notify_comment.go and includes the agent job (passed as mainJobName). Current compilation shows:

conclusion:
  needs:
    - activation
    - agent
    - detection
    - safe_outputs
    - update_cache_memory

No changes needed - this dependency is properly configured.

pelikhan · 2026-01-15T15:17:45Z

@copilot fix syntax:

Error: Invalid value for '--transport': 'http' is not one of 'stdio', 'sse', 'streamable-http'.

Changed --transport http to --transport streamable-http in start_serena_server.sh. The Serena CLI only accepts 'stdio', 'sse', or 'streamable-http' as valid transport options. Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-01-15T15:26:24Z

@copilot fix syntax:

Error: Invalid value for '--transport': 'http' is not one of 'stdio', 'sse', 'streamable-http'.

Done in 5e38449. Changed --transport http to --transport streamable-http in start_serena_server.sh. The Serena CLI accepts 'stdio', 'sse', or 'streamable-http' as valid transport options.

github-actions · 2026-01-15T15:29:45Z

🎬 THE END — Smoke Claude MISSION: ACCOMPLISHED! The hero saves the day! ✨

github-actions · 2026-01-15T15:30:00Z

✨ The prophecy is fulfilled... Smoke Codex has completed its mystical journey. The stars align. 🌟

github-actions · 2026-01-15T15:30:04Z

🎉 Yo ho ho! Changeset Generator found the treasure and completed successfully! ⚓💰

github-actions · 2026-01-15T15:33:22Z

Smoke Test Results (Run #21036691357)

Last 2 Merged PRs:

Fix JSDoc return type annotations in close_expired_*.cjs #10091: Fix JSDoc return type annotations in close_expired_*.cjs
[WIP] Add campaign for security alert burndown #10094: [WIP] Add campaign for security alert burndown (closed, not merged)

Test Results:

✅ GitHub MCP - Retrieved PRs successfully
✅ Serena - Initialized project (gh-aw, go/typescript/bash)
✅ Playwright - Navigated to github.com, title verified
✅ Tavily - Web search returned 5 results
✅ File Writing - Created test file successfully
✅ Bash Tool - Verified file creation
❌ Go Command - Not available in environment

Overall: PASS (6/7 tests passed; Go unavailable expected in CI environment)

AI generated by Smoke Claude

pelikhan · 2026-01-15T15:38:10Z

@copilot Finish adding tests

Added tests to cover Serena local mode functionality: 1. importable_tools_test.go: - TestImportSerenaLocalMode: Tests importing Serena with local mode, verifies HTTP transport, port config, shell script call, and runtime setups - TestImportSerenaLocalModeMultipleLanguages: Tests local mode with multiple language runtimes (Go, TypeScript, Python) 2. mcp_config_comprehensive_test.go: - TestRenderSerenaMCPConfigLocalMode: Tests MCP config rendering for local mode with HTTP transport vs docker mode with stdio All tests verify: - HTTP transport configuration for local mode - Shell script invocation (start_serena_server.sh) - Language runtime detection and setup - Proper defaults (docker mode when not specified) - No API key/Authorization header in local mode Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-01-15T15:48:22Z

@copilot Finish adding tests

Done in e07befe. Added comprehensive tests for Serena local mode:

importable_tools_test.go:

TestImportSerenaLocalMode: Verifies HTTP transport, shell script call, and runtime setups for single language
TestImportSerenaLocalModeMultipleLanguages: Tests multiple language runtimes (Go, TypeScript, Python)

mcp_config_comprehensive_test.go:

TestRenderSerenaMCPConfigLocalMode: Tests MCP config rendering for both local (HTTP) and docker (stdio) modes

All tests pass and verify proper HTTP transport configuration, language runtime detection, and correct defaults.

Initial plan

60ac3be

Copilot AI assigned Copilot and pelikhan Jan 15, 2026

Copilot started work on behalf of pelikhan January 15, 2026 13:28 View session

Add local uvx mode support for serena tool with HTTP transport

f235c14

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add option to run Serena tool using UVX~~ Add local uvx mode to Serena tool with HTTP transport Jan 15, 2026

Copilot AI requested a review from pelikhan January 15, 2026 13:55

Copilot finished work on behalf of pelikhan January 15, 2026 13:55

Copilot started work on behalf of pelikhan January 15, 2026 13:55 View session

pelikhan approved these changes Jan 15, 2026

View reviewed changes

Copilot finished work on behalf of pelikhan January 15, 2026 14:06

Copilot AI requested a review from pelikhan January 15, 2026 14:06

Copilot started work on behalf of pelikhan January 15, 2026 14:06 View session

pelikhan added the smoke label Jan 15, 2026

Copilot finished work on behalf of pelikhan January 15, 2026 14:44

Copilot started work on behalf of pelikhan January 15, 2026 14:45 View session

github-actions bot added the smoke-claude label Jan 15, 2026

Copilot finished work on behalf of pelikhan January 15, 2026 15:08

Copilot started work on behalf of pelikhan January 15, 2026 15:09 View session

Copilot finished work on behalf of pelikhan January 15, 2026 15:16

Copilot started work on behalf of pelikhan January 15, 2026 15:21 View session

Copilot finished work on behalf of pelikhan January 15, 2026 15:27

pelikhan added smoke and removed smoke smoke-claude labels Jan 15, 2026

github-actions bot added the smoke-claude label Jan 15, 2026

Copilot started work on behalf of pelikhan January 15, 2026 15:38 View session

Copilot finished work on behalf of pelikhan January 15, 2026 15:53

pelikhan marked this pull request as ready for review January 15, 2026 15:54

pelikhan merged commit 01fd250 into main Jan 15, 2026

pelikhan deleted the copilot/add-uvx-support-for-serena branch January 15, 2026 15:55

Add local uvx mode to Serena tool with HTTP transport #10073

Add local uvx mode to Serena tool with HTTP transport #10073

Uh oh!

Conversation

Copilot AI commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Plan: Add Local uvx Mode to Serena Tool

Uh oh!

pelikhan commented Jan 15, 2026

Uh oh!

pelikhan Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

pelikhan Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Jan 15, 2026

Uh oh!

github-actions bot commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pelikhan commented Jan 15, 2026

Uh oh!

github-actions bot commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 15, 2026 • edited by agentic-workflows-dev bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 15, 2026

Smoke Test Results

Uh oh!

Copilot AI commented Jan 15, 2026

Uh oh!

pelikhan commented Jan 15, 2026

Uh oh!

Copilot AI commented Jan 15, 2026

Uh oh!

pelikhan commented Jan 15, 2026

Uh oh!

Copilot AI commented Jan 15, 2026

Uh oh!

github-actions bot commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 15, 2026 • edited by agentic-workflows-dev bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 15, 2026

Smoke Test Results (Run #21036691357)

Uh oh!

pelikhan commented Jan 15, 2026

Uh oh!

Copilot AI commented Jan 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Jan 15, 2026 •

edited

Loading

github-actions bot commented Jan 15, 2026 •

edited

Loading

github-actions bot commented Jan 15, 2026 •

edited

Loading

github-actions bot commented Jan 15, 2026 •

edited

Loading

github-actions bot commented Jan 15, 2026 •

edited by agentic-workflows-dev bot

Loading

github-actions bot commented Jan 15, 2026 •

edited

Loading

github-actions bot commented Jan 15, 2026 •

edited

Loading

github-actions bot commented Jan 15, 2026 •

edited by agentic-workflows-dev bot

Loading