Skip to content

feat(matifali): add Omnigent multi-agent server module#925

Merged
DevelopmentCats merged 20 commits into
mainfrom
add-omnigent-module
Jul 20, 2026
Merged

feat(matifali): add Omnigent multi-agent server module#925
DevelopmentCats merged 20 commits into
mainfrom
add-omnigent-module

Conversation

@matifali

@matifali matifali commented Jun 16, 2026

Copy link
Copy Markdown
Member

Summary

Adds an Omnigent module under the personal matifali namespace. The module installs and starts Omnigent, registers the workspace as a host, and exposes the Omnigent Coder app.

The standalone Docker example template has been removed from this PR and extracted to a separate branch based on main.

Changes

  • Add the matifali contributor namespace with GitHub profile matifali.
  • Publish the module from registry/matifali/modules/omnigent.
  • Install uv when it is not already available, then install Omnigent through its official installer.
  • Start the Omnigent server and workspace host without blocking Coder startup.
  • Derive trusted Coder app origins and pass them through OMNIGENT_WS_ALLOWED_ORIGINS.
  • Pass OPENAI_CODER_AIGATEWAY_SESSION_TOKEN to host-launched runners while preserving existing OMNIGENT_RUNNER_ENV_PASSTHROUGH values.
  • Support custom ports, additional trusted origins, server policy configuration, custom agent YAML, and an existing server configuration path.
  • Document minimal and comprehensive integration patterns for Docker, Kubernetes, and VM templates.
  • Document Claude Code 5.2.0, Codex 5.2.1, Coder AI Gateway, dependency installation, and coder exp sync ordering.

Validation

  • go build ./cmd/readmevalidation
  • ./readmevalidation
    • 24 valid contributor profiles
    • 80 valid module READMEs
    • 36 valid template READMEs
    • Skills validation passed
  • terraform fmt -check -recursive registry/matifali/modules/omnigent
  • terraform test -no-color in registry/matifali/modules/omnigent: 22 passed, 0 failed
  • MODULE_CHANGED_FILES='registry/matifali/modules/omnigent/main.tf registry/matifali/modules/omnigent/scripts/start.sh.tftpl registry/matifali/modules/omnigent/scripts/install.sh.tftpl' ./scripts/terraform_validate.sh
  • Full E2E in Coder workspace test-omnigent-pr-925-full:
    • Workspace build fix: update script path #6 succeeded and reached ready.
    • GET /health returned { "status": "ok" }.
    • The workspace host registered with Claude Code and Codex available.
    • A fresh Codex-native session received OPENAI_CODER_AIGATEWAY_SESSION_TOKEN and returned ok with no task error.

🤖 This PR was created with the help of Coder Agents, and needs a human review. 🧑💻

matifali added 4 commits June 16, 2026 12:48
Blocking fixes:
- Add PATH export at top of start.sh so omnigent is found after install
- Separate server.log from start.log (nohup concurrent write conflict)
- Bump coder provider constraint from >= 2.12 to >= 2.13 (matches coder-utils)
- Base64-encode omnigent version in install.sh (injection hardening)
- Surface upgrade failures as warnings instead of silencing them

New inputs:
- server_config: inline YAML written to module dir and passed as -c
- server_config_path: path to existing config file, mutually exclusive with server_config
- agents: list of {name, content} pre-registered at startup via --agent flags
- pre_install_script / post_install_script: pass-through to coder-utils

New output: server_config_path (effective config path or empty string)

13/13 tests pass.
@matifali
matifali marked this pull request as draft June 21, 2026 16:39
@DevelopmentCats

Copy link
Copy Markdown
Collaborator

I have set this up locally I will be testing this and leaving my feedback this week so we can get this module in. @matifali

@DevelopmentCats DevelopmentCats self-assigned this Jul 8, 2026
@matifali
matifali requested a review from DevelopmentCats July 17, 2026 18:34
@matifali
matifali marked this pull request as ready for review July 17, 2026 18:34
@DevelopmentCats

Copy link
Copy Markdown
Collaborator

Was running into some issues with omnigent locally un-related to the module but I am finishing up testing now.

Comment thread registry/coder-labs/modules/omnigent/scripts/start.sh.tftpl Outdated
@matifali matifali changed the title feat(coder-labs): add Omnigent multi-agent server module feat(matifali): add Omnigent multi-agent server module Jul 20, 2026
@matifali
matifali requested a review from DevelopmentCats July 20, 2026 16:38
@DevelopmentCats
DevelopmentCats merged commit f3de285 into main Jul 20, 2026
4 checks passed
@DevelopmentCats
DevelopmentCats deleted the add-omnigent-module branch July 20, 2026 16:43
DevelopmentCats pushed a commit that referenced this pull request Jul 20, 2026
## Summary

Adds an Omnigent Docker template under the personal `matifali`
namespace, combining Omnigent, Claude Code, Codex, Coder AI Gateway, and
a shallow clone of `github.com/coder/coder`.

This was extracted from #925 so the reusable Omnigent module and the
opinionated Docker template can be reviewed independently.

## Changes

- Add the template under `registry/matifali/templates/omnigent-docker`.
- Add the `matifali` contributor profile and link the hosted Omnigent
module and Docker template.
- Configure Claude Code and Codex through Coder AI Gateway.
- Use compatible module constraints so minor and patch releases are
selected automatically.
- Install shared dependencies required by the AI tools on the
Ubuntu-based image.
- Coordinate repository cloning, AI tool setup, and Omnigent startup
with `coder exp sync`.
- Add the Omnigent registry icon.

## Validation

- `terraform fmt -check -recursive
registry/matifali/templates/omnigent-docker`
- Imported the exact PR template as Coder template version
`e77335c8-2899-449e-8fb6-fa7e4c516b99`.
- Terraform initialized and planned successfully, resolving:
  - `matifali/omnigent` `0.0.1`
  - `coder/git-clone` `2.0.2`
  - `coder/claude-code` `5.2.0`
  - `coder-labs/codex` `5.3.0`
- Created workspace `test-omnigent-docker-pr-1022` from the imported
template.
- Workspace build #1 succeeded with 16 resources created and reached
`ready`.
- Verified:
  - Omnigent app health is `healthy`.
  - `GET /health` returns `{ "status": "ok" }`.
  - The Coder repository was cloned successfully.
- Claude Code `2.1.215`, Codex CLI `0.144.6`, and Omnigent `0.5.1` are
installed.
  - Omnigent server and host processes are running.
  - The Omnigent host is connected to the local server.
  - All startup scripts completed successfully.

Continuation of #925

> 🤖 This PR was created with the help of Coder Agents, and needs a human
review. 🧑💻
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants