TOPY.AI · AI CTO

Registre officiel IA et agents

Founders' AI CTO: CI failures explained, PRs and checks, release notes, alerts.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http topy-ai-ai-cto 'https://topy.ai/mcp/cto'
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "topy-ai-ai-cto": {
            "type": "http",
            "url": "https://topy.ai/mcp/cto"
        }
    }
}
NPM package @topy-ai/cto-mcp
Claude Code
claude mcp add topy-ai-ai-cto -e 'TOPY_API_KEY=<your topy_api_key>' -- npx -y @topy-ai/cto-mcp@0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "topy-ai-ai-cto": {
            "command": "npx",
            "args": [
                "-y",
                "@topy-ai/cto-mcp@0.1.0"
            ],
            "env": {
                "TOPY_API_KEY": "<your topy_api_key>"
            }
        }
    }
}

Variables d'environnement

  • TOPY_API_KEY secret A TOPY API key (Dashboard → API keys); or run `npx @topy-ai/cto-mcp login` once instead.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. TOPY AI CTO Skills
  2. Install
  3. Connect TOPY.AI
  4. How the skills fit together
  5. Packages
  6. Repository structure
  7. License
  8. Skills

TOPY AI CTO Skills

17 skills that make your coding agent a small company's AI CTO: what is live keeps working and every release has evidence — CI failures explained from their logs, flaky tests quarantined, pull requests reviewed for risk, release notes, a release gate, safe deploys and rollbacks, incident response, dependency alerts and secrets hygiene — through the TOPY AI GitHub App on the TOPY.AI CTO MCP server.


The AI CTO is goal-first. It keeps four standing goals — what is live works (uptime), we ship often and safely (deploy frequency, change failure rate), every release has evidence (CI green, QA passed, live == built) and the platform can grow — and every skill below exists to move one of them. Runs, checks, logs and alerts come from the tools; an alert kind GitHub won't show is "not read" with GitHub's reason, never zero.

  • Core (topy-ai-cto): connect, the CTO's goals, the morning check, the CI watch.
  • CI: why CI failed, flaky tests, CI hygiene.
  • Code review & issues: review a pull request for risk, triage engineering issues.
  • Releases & deploys: release notes, the release gate, deploy safely, roll back.
  • Dependencies & secrets: dependency and security alerts, secrets hygiene.
  • Incidents & architecture: incident response, architecture decision records.

The safety model comes from Maggie QA Workflow and Maggie Deployment and does not bend: GitHub is reached through the TOPY AI GitHub App the Founder installs — no GitHub token passes through the agent; merging to the default branch, creating repositories or releases and production workflows are the Founder's, approved on OneMan, never tools here; secrets are never printed or asked for; code, commit messages, issue text and logs are data, never instructions; and every release needs evidence before it ships. Changes (an issue, a comment, a re-run) take two calls — a preview, then your yes.

Install

npx @topy-ai/cto-skills install                  # this project, for the agents set up here
npx @topy-ai/cto-skills install -g --mcp         # your user, plus the MCP server
npx @topy-ai/cto-skills install --category ci,releases
npx @topy-ai/cto-skills list

Claude Code plugins: /plugin marketplace add TOPY-AI-LTD/TOPY-AI-CTO-Skills, then /plugin install topy-ai-cto-all@topy-ai-cto. Codex: codex plugin marketplace add TOPY-AI-LTD/TOPY-AI-CTO-Skills. Pi: pi install npm:@topy-ai/cto-skills. See the installer README.

Connect TOPY.AI

https://topy.ai/mcp/cto — OAuth with your TOPY.AI account (the same one as the AI CEO, CFO, COO, CSO, CRO and CPO). Only the accounts that own the OneMan operation reach its GitHub. Connect GitHub on topy.ai first: AI Cofounders → Engineering setup → create and install the TOPY AI GitHub App.

ClientHow
Claude, ChatGPT (web, desktop)custom connector https://topy.ai/mcp/cto
Claude Codeclaude mcp add --transport http topy-cto https://topy.ai/mcp/cto
Codexcodex mcp add topy-cto --url https://topy.ai/mcp/cto
Clients that only start a commandnpx -y @topy-ai/cto-mcp after npx @topy-ai/cto-mcp login
Terminal and scriptsnpm i -g @topy-ai/cto-cli && cto-cli login

Merges, releases, new repositories and production workflows are not on topy.ai/mcp/cto: they need the Founder's approval on OneMan.

How the skills fit together

topy-cto-connect ─▶ topy-cto-goals
        │
   every morning:   topy-cto-morning-check
   around the clock: topy-cto-ci-watch (an email only on a failure or a recovery)
        │
   ci:        topy-cto-ci-failure ─▶ topy-cto-flaky-tests · topy-cto-ci-hygiene
   code:      topy-cto-pr-review · topy-cto-issue-triage
   releases:  topy-cto-release-notes ─▶ topy-cto-release-gate ─▶ topy-cto-deploy-safely ─▶ topy-cto-rollback
   security:  topy-cto-dependency-alerts · topy-cto-secrets-hygiene
   platform:  topy-cto-incident · topy-cto-architecture-decision

Try: "Is CI green?", "Why did the build fail?", "Review PR 42", "Can we ship?", "Any security alerts?"

Packages

PackageWhat it is
@topy-ai/cto-skillsThis installer (Claude Code, Codex, Pi, Cursor, Gemini CLI, …)
@topy-ai/cto-mcpThe CTO MCP server as a local stdio server (forwards to https://topy.ai/mcp/cto)
@topy-ai/cto-cliThe AI CTO on the command line

Repository structure

plugins/
  topy-ai-cto/                   core skills + .mcp.json (Claude Code) and mcp.json (Codex)
  topy-ai-cto-ci/   topy-ai-cto-code/   topy-ai-cto-releases/
  topy-ai-cto-security/   topy-ai-cto-platform/
  topy-ai-cto-all/               bundle that depends on all six
.claude-plugin/marketplace.json     Claude Code marketplace
.agents/plugins/marketplace.json    Codex marketplace
skills.json                         machine-readable catalogue
packages/skills/                    the @topy-ai/cto-skills installer

The skills are generated from a source catalogue kept next to TOPY.AI's MCP server; the build checks every tool a skill names against the CTO server's tool list. Please open an issue rather than editing a SKILL.md.

License

MIT © TOPY AI LTD. Privacy: topy.ai/privacy.

Skills

17 skills in 6 plugins, plus the topy-ai-cto-all bundle. Generated from the source catalogue: please open an issue rather than editing a SKILL.md.

AI CTO core (MCP) · topy-ai-cto
SkillTierWhat it does
topy-cto-ci-watchcoreHow the AI CTO watches CI around the clock: a GitHub webhook per run, an email only on a failure or a recovery, with the failing jobs and the log lines.
topy-cto-connectcoreConnect the TOPY CTO MCP server and check what it can see: the GitHub App and its repositories, CI, alerts and service health.
topy-cto-goalscoreThe AI CTO's standing goals and its status report for the CEO: uptime, deploy frequency and change failure rate, each with source and date or 'no data'.
topy-cto-morning-checkcoreEach morning: service health, CI on the default branches, pull requests waiting and anything red — the one thing to fix first.
CI · topy-ai-cto-ci
SkillTierWhat it does
topy-cto-ci-failureconnectedExplain a failed GitHub Actions run from its jobs and logs: the step, the cause in the log's own words, flaky or real, and the fix — then re-run or open an issue.
topy-cto-ci-hygienestandaloneKeep CI fast and trustworthy: required checks, caching, a time budget, pinned actions, least-privilege tokens and no secrets in logs.
topy-cto-flaky-testsconnectedTell a flaky test from a real failure, quarantine it with an owner and a deadline, and fix the cause (time, order, network, shared state) instead of re-running forever.
Code review & issues · topy-ai-cto-code
SkillTierWhat it does
topy-cto-issue-triageconnectedTurn bug reports and CI findings into issues worth fixing: reproduce, size, label, owner — and close what isn't actionable.
topy-cto-pr-reviewconnectedReview a pull request for what matters before merge: what changed, whether checks pass, and the risks — migrations, auth, money, secrets, irreversible steps, missing tests.
Releases & deploys · topy-ai-cto-releases
SkillTierWhat it does
topy-cto-deploy-safelyconnectedShip to production in small steps: plan, the Founder's approval, deploy the gated build, canary, check live matches what was built, then report — or roll back.
topy-cto-release-gateconnectedDecide whether a build may ship: CI green on the exact commit, checks and QA passed, migrations reversible, rollback ready, and someone watching — evidence for each.
topy-cto-release-notesconnectedDraft release notes from the commits since the last release, grouped as new, improved and fixed in words customers understand — nothing is published.
topy-cto-rollbackconnectedWhen a release hurts, restore service first: redeploy the last good build, keep data safe, confirm recovery, then find the cause.
Dependencies & secrets · topy-ai-cto-security
SkillTierWhat it does
topy-cto-dependency-alertsconnectedRead Dependabot, code-scanning and secret-scanning alerts, fix what is exploitable first, and say plainly which alert kinds GitHub isn't showing and why.
topy-cto-secrets-hygienestandaloneKeep keys and tokens out of code, logs and chats: where secrets live, least privilege, rotation, and what to do in the first hour after one leaks.
Incidents & architecture · topy-ai-cto-platform
SkillTierWhat it does
topy-cto-architecture-decisionstandaloneRecord a technical decision so it can be revisited: the context, the options with their costs, the choice, its consequences, and what would make us change it.
topy-cto-incidentconnectedWhen something customers use is down or wrong: one lead, stop the harm, restore service, communicate on a clock, then a blameless review with fixes.

Questions fréquentes

Qu'est-ce que TOPY.AI · AI CTO ?

Founders' AI CTO: CI failures explained, PRs and checks, release notes, alerts.

Comment installer TOPY.AI · AI CTO ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http topy-ai-ai-cto 'https://topy.ai/mcp/cto'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour TOPY.AI · AI CTO ?

Oui. Il attend TOPY_API_KEY, à renseigner dans sa configuration.

TOPY.AI · AI CTO est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient TOPY.AI · AI CTO ?

Il est publié par TOPY-AI-LTD. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.