TOPY.AI · AI CTO
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 »).
claude mcp add --transport http topy-ai-ai-cto 'https://topy.ai/mcp/cto'
{
"mcpServers": {
"topy-ai-ai-cto": {
"type": "http",
"url": "https://topy.ai/mcp/cto"
}
}
}
@topy-ai/cto-mcpclaude mcp add topy-ai-ai-cto -e 'TOPY_API_KEY=<your topy_api_key>' -- npx -y @topy-ai/cto-mcp@0.1.0
{
"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_KEYsecret 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
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.
| Client | How |
|---|---|
| Claude, ChatGPT (web, desktop) | custom connector https://topy.ai/mcp/cto |
| Claude Code | claude mcp add --transport http topy-cto https://topy.ai/mcp/cto |
| Codex | codex mcp add topy-cto --url https://topy.ai/mcp/cto |
| Clients that only start a command | npx -y @topy-ai/cto-mcp after npx @topy-ai/cto-mcp login |
| Terminal and scripts | npm 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
| Package | What it is |
|---|---|
@topy-ai/cto-skills | This installer (Claude Code, Codex, Pi, Cursor, Gemini CLI, …) |
@topy-ai/cto-mcp | The CTO MCP server as a local stdio server (forwards to https://topy.ai/mcp/cto) |
@topy-ai/cto-cli | The 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
| Skill | Tier | What it does |
|---|---|---|
topy-cto-ci-watch | core | How 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-connect | core | Connect the TOPY CTO MCP server and check what it can see: the GitHub App and its repositories, CI, alerts and service health. |
topy-cto-goals | core | The 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-check | core | Each 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
| Skill | Tier | What it does |
|---|---|---|
topy-cto-ci-failure | connected | Explain 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-hygiene | standalone | Keep CI fast and trustworthy: required checks, caching, a time budget, pinned actions, least-privilege tokens and no secrets in logs. |
topy-cto-flaky-tests | connected | Tell 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
| Skill | Tier | What it does |
|---|---|---|
topy-cto-issue-triage | connected | Turn bug reports and CI findings into issues worth fixing: reproduce, size, label, owner — and close what isn't actionable. |
topy-cto-pr-review | connected | Review 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
| Skill | Tier | What it does |
|---|---|---|
topy-cto-deploy-safely | connected | Ship 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-gate | connected | Decide 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-notes | connected | Draft release notes from the commits since the last release, grouped as new, improved and fixed in words customers understand — nothing is published. |
topy-cto-rollback | connected | When 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
| Skill | Tier | What it does |
|---|---|---|
topy-cto-dependency-alerts | connected | Read 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-hygiene | standalone | Keep 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
| Skill | Tier | What it does |
|---|---|---|
topy-cto-architecture-decision | standalone | Record 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-incident | connected | When 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.