{"id":49262908,"url":"https://github.com/oaslananka/codex-app-server-web","last_synced_at":"2026-04-25T08:38:41.732Z","repository":{"id":347685199,"uuid":"1194533535","full_name":"oaslananka/codex-app-server-web","owner":"oaslananka","description":"A high-performance Codex web interface for orchestrating agent workflows, threads, and runtime execution. Includes real-time streaming, RPC-based communication, and a modular multi-panel UI built with Next.js and React.","archived":false,"fork":false,"pushed_at":"2026-04-05T23:46:16.000Z","size":837,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T00:16:21.409Z","etag":null,"topics":["ai","codex","developer-tools","nextjs","react","state-management","typescript","ui","ux","websocket"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oaslananka.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-28T13:41:35.000Z","updated_at":"2026-04-05T23:46:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oaslananka/codex-app-server-web","commit_stats":null,"previous_names":["oaslananka/codex-app-server-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oaslananka/codex-app-server-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fcodex-app-server-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fcodex-app-server-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fcodex-app-server-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fcodex-app-server-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oaslananka","download_url":"https://codeload.github.com/oaslananka/codex-app-server-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fcodex-app-server-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32256059,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T04:23:17.126Z","status":"ssl_error","status_checked_at":"2026-04-25T04:21:53.360Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","codex","developer-tools","nextjs","react","state-management","typescript","ui","ux","websocket"],"created_at":"2026-04-25T08:38:41.244Z","updated_at":"2026-04-25T08:38:41.722Z","avatar_url":"https://github.com/oaslananka.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# codex-app-server-web\n\n`codex-app-server-web` is an independent, open-source web interface for Codex app-server workflows. It provides a browser-based control center for working with threads, chat, terminal sessions, files, configuration, approvals, MCP visibility, and runtime diagnostics while staying compatible with existing app-server backends.\n\nThis project is independent and community-maintained. It is not affiliated with, endorsed by, or maintained by OpenAI.\n\n**Overview**\n\nThe goal of this repository is to make Codex app-server workflows easier to inspect and operate from the browser without changing the backend protocol. It is designed for developer-facing use cases where you want a practical UI for session management, approvals, diagnostics, and workspace interaction, while keeping protocol compatibility and schema-driven behavior intact.\n\nAzure DevOps is the source of truth for CI/CD, release validation, and the primary delivery workflow. GitHub is maintained as the public open-source mirror for discoverability, issue tracking, and community contributions.\n\n**Core Capabilities**\n\n- Browser-based access to conversation threads and live chat activity\n- Terminal execution with streamed output and interactive stdin\n- File browsing, editing, copy/remove actions, and path-aware navigation\n- Schema-driven config editing with generic fallback support for unknown fields\n- Approval flows for commands, file changes, permissions, user input, and auth refreshes\n- MCP server visibility, plugin inspection, external agent import, and runtime diagnostics\n- Workspace utilities such as fuzzy file search, git diff visibility, and review-thread entry points\n\n**Stack**\n\n- Next.js App Router\n- React 19\n- Fastify\n- WebSocket transport with `ws`\n- TypeScript\n- pnpm\n- Node.js 20+\n\n**Project Structure**\n\n- [`app/`](./app): Next.js app shell, layout, and entry routes\n- [`src/components/`](./src/components): Codex control center UI, overlays, panels, and shared UI primitives\n- [`src/lib/`](./src/lib): Runtime, transport, protocol-facing logic, and supporting utilities\n- [`src/styles/`](./src/styles): Control center styling, responsive behavior, and overlay/panel presentation\n- [`scripts/`](./scripts): Manifest generation, smoke tooling, vendor sync, and local backend helpers\n- [`tests/unit/`](./tests/unit): Unit coverage for runtime behavior, protocol handling, overlays, and panel utilities\n- [`azure-pipelines.yml`](./azure-pipelines.yml): Primary CI/CD pipeline definition\n- [`TECH_DEBT.md`](./TECH_DEBT.md): Explicitly accepted debt and known boundaries\n\n**Local Development**\n\nInstall dependencies and start the app with a local Codex backend:\n\n```bash\npnpm install\npnpm dev\n```\n\nIf you want a local backend stub for UI work, start the mock app-server in a second terminal:\n\n```bash\npnpm start:mock-codex\n```\n\nThe UI server can also be started directly without the helper wrapper:\n\n```bash\npnpm start:ui\n```\n\n**Useful Commands**\n\n```bash\npnpm dev\npnpm start\npnpm start:prod\npnpm start:mock-codex\npnpm typecheck\npnpm test\npnpm build\npnpm protocol:manifest:check\npnpm smoke\n```\n\n**CI/CD**\n\n- Azure DevOps is the authoritative pipeline and release path for this project.\n- [`azure-pipelines.yml`](./azure-pipelines.yml) defines the primary validation and delivery flow.\n- The GitHub mirror is intentionally secondary and does not replace Azure DevOps as the release source of truth.\n- Protocol metadata can be validated locally with `pnpm protocol:manifest:check` before opening a change.\n\n**Contribution Guidance**\n\n- Prefer incremental, protocol-safe improvements over large speculative rewrites.\n- Preserve compatibility with existing Codex app-server backends unless a change is intentionally versioned.\n- Keep schema-driven config behavior generic enough to handle unknown or forward-compatible fields.\n- Add or update focused tests when runtime behavior, transport behavior, or UI state coordination changes.\n- Run `pnpm typecheck`, `pnpm test`, and `pnpm build` before proposing a change.\n- If you touch protocol-facing metadata, also run `pnpm protocol:manifest:check`.\n\n**Compatibility Goals**\n\n- Remain compatible with Codex app-server workflows and the surrounding Codex / OpenAI ecosystem at the protocol level\n- Avoid backend-specific UI assumptions that would break existing app-server integrations\n- Preserve approval handling, config schema fallback behavior, and transport semantics where possible\n- Improve presentation and operator ergonomics without rebranding the project as an official vendor product\n\n**License**\n\nThis project is available under the MIT License. See [`LICENSE`](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foaslananka%2Fcodex-app-server-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foaslananka%2Fcodex-app-server-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foaslananka%2Fcodex-app-server-web/lists"}