Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 20 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,8 @@ codex plugin add mainsequence@mainsequence

## Sign in and choose an environment

Ask Codex to **open MainSequence**. The panel has **Home, Code, Projects, Agents, Tools,
Activity** and **Settings**.
Ask Codex to **open MainSequence**. The panel has **Home, Code, Releases, Projects, Agents,
Tools, Activity** and **Settings**.

1. In **Settings**, choose **Sign in with browser**. The hosted MainSequence login opens in
your browser; account creation is part of that flow. The session is saved in your
Expand Down Expand Up @@ -109,8 +109,25 @@ change it.
- **Projects.** The environment's MainSequence projects with their repository branches.
**Set up project locally** prepares every member branch in its own checkout and hands
the workspace to Codex, with a project `AGENTS.md`.
- **Releases.** The environment's APIs, agents and static sites, each with its last ten
runs as colored dots and how many of its runs of the last 30 days succeeded (superseded,
cancelled and skipped runs don't count); filter by kind, or by the repository of a local folder (**Code → View releases**). Releases that
are deploying come first, with their commit, stage and elapsed time. A release shows the
commit it serves and the one it wants, its success rate, median time, slowest stage and
most common failure over 7, 30 or 90 days, and its runs; a run opens its stages and logs.
Read-only. Nothing is read again while nothing deploys. While a shown run is queued or
running, the panel checks only the active runs every 30 s and reads the screen again
once one of them ends; checks wait while the panel is hidden and pause after an hour
(**Refresh** starts them again).
- **Deployments.** The latest run of a repository branch, its stages and logs, and the
environment's deployment history. Read-only.
environment's deployment history, including jobs and images. A running deployment's
details are read again every 10 s while they are on screen, with the same pauses.
Read-only.
- **Ask about deployments.** "What is deploying right now?", "How reliable has
pricing-api been this month?", "Wait for that deployment to finish." Codex reads
releases, their history and stats, and the active runs with `mainsequence_workspace`,
and waits for a run at most two minutes per call, calling again while it still runs.
None of these reads deploys anything.
- **Activity.** Running and finished operations with progress, results and cancellation.
- **`/ms` commands.** In Codex desktop, type `/ms`, select **ms** from the slash menu,
append the arguments and submit, for example `/ms --help`, `/ms status`, `/ms sync`. The
Expand Down
7 changes: 4 additions & 3 deletions docs/agents-tools-panel.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,15 @@ stay unchanged. No probe or custom Codex build is shipped.

| Surface | Implemented behavior |
| --- | --- |
| Header/navigation | MainSequence emblem, shared account with when its login ends, environment, Activity, Settings; Home/Code/Projects/Agents/Tools; compact rows and grouped details; host theme variables, neutral fallbacks and reduced-motion icons |
| Header/navigation | MainSequence emblem, shared account with when its login ends, environment, Activity, Settings; Home/Code/Releases/Projects/Agents/Tools; compact rows and grouped details; host theme variables, neutral fallbacks and reduced-motion icons |
| Agents | Search/pages, real icons, defaults, descriptions, skills/examples; Talk prepares a stable session without sending; new conversations; drafts survive browsing; direct messages and task mode |
| Native context/recovery | Immutable request saved before native submission, at-most-once dispatch, durable receipts, same-ID recovery, uncertain sends blocked; native MCP results and labelled replies remain conversation context |
| Agent tasks | Accepted task receipt, get/wait/cancel, continue an owned saved task, outputs in native context; no task read/recovery resends the original message |
| Tools | Saved connections, Add MCP, connect/disconnect review, fresh schemas, explicit JSON tool-call review; catalog cache survives refresh failure; stable model-facing discovery/call tools |
| Code | Remote/local search, branch selection, setup with optional install; folder/type, status/resolve/SDK; sync/install/SDK update and preview; instructions/skills and preview/sync; environment cleanup; Docker build preview; devcontainer preview/write; local deletion preview and explicit confirmation |
| Projects | Search/pages, branch counts, descriptions, repository/branch links; local setup/update with Codex AGENTS.md; progress, cancellation, partial-effect reporting and explicit native workspace handoff |
| Deployments | Environment/branch history, pages, run/workflow stages, related runs, durations, errors, active-run polling, stage logs, log filtering/cursors; read-only |
| Releases | Environment releases (APIs, agents, static sites) with kind and local-repository filters, the last ten run states, success counts or the last failure, deploying releases first with commit, stage and elapsed time, pages; a release's serving and wanted revisions, 7/30/90-day stats (runs, success rate, median time, slowest stage, most common failure) and runs that open the run detail; read-only. No re-read while nothing deploys; while a shown run is active, `deployment-active` every 30 s and one re-read when a watched run ends; checks wait while hidden, never overlap and pause after an hour |
| Deployments | Environment/branch history, pages, run/workflow stages, related runs, durations, errors, stage logs, log filtering/cursors; a running run's details re-read every 10 s while shown and visible, pausing after an hour; read-only |
| Settings | Existing shared account, browser login, connection check, renewal, explicit shared sign-out; repositories folder/backend/Command Center settings; diagnostics and local scan |
| Activity | Agent receipts/tasks plus accepted workspace operations, progress, explicit cancellation and results; accepted workspace work survives panel close/native Stop while the server remains alive |

Expand Down Expand Up @@ -172,7 +173,7 @@ updates the plugin.
| `mainsequence_agent_status` | Saved request/receipt list, get and wait; no sending |
| `mainsequence_agent_task` | Owned saved-task get, wait and cancellation |
| `mainsequence_submission` | App-only native submission acknowledgement bookkeeping; no remote dispatch |
| `mainsequence_workspace` | Scoped repository/SDK/local status, previews and public deployment reads |
| `mainsequence_workspace` | Scoped repository/SDK/local status, previews and public deployment reads: history, runs, logs, releases (`deployment-releases`, `deployment-release`), active runs (`deployment-active`) and `deployment-wait`, at most 120 s per call |
| `mainsequence_action` | Reviewed allowlisted devtools repository/project operations |
| `mainsequence_operations` | Host-owned accepted-operation status and cancellation |
| `mainsequence_settings` | Public shared preferences and existing shared-session login/renewal/sign-out |
Expand Down
Loading
Loading