NEWThe Harness for AI coding agents is here
See your whole architecture. Auto-generated from your code.

Connect a repo. Archyl maps every system, service, and dependency into an interactive C4 model, then keeps it in sync on every push.

Free plan forever · No credit card required

app.archyl.com

Aurora Commerce

Platform team

Project

Systems

Storefront
Checkout
Payments
Fulfilment
AL

Ada Lovelace

Architect

Aurora Commerce/Checkout/System context
Search the architecture…K
ALMDKS
AI
System ContextContainerComponentCode
Time travelAuto layoutOverlayRealityShare
PCI scope
Browses & ordersREST/JSONAuthorize paymentpublishes OrderPlaced

Customer

PERSON

Shops and tracks orders.

Storefront

SYSTEM

Web and mobile shopping experience.

claude-code/ada

Checkout

SYSTEM

Cart, order placement and payment flow.

Payments

SYSTEM

Authorisation, capture and refunds.

Stripe

EXTERNAL

Card processing provider.

Fulfilment

SYSTEM

Picking, shipping and returns.

Add N Link LDouble-click to drill down

An interactive C4 model, from system context down to code.

C4 levels, from context to code

0

MCP tools for your AI agents

0+

Git providers, cloud or self-hosted

0

languages, in the app and the docs

0

Plugs into the repositories, agents and tools your team already uses

  • GitHub
  • GitLab
  • Anthropic
  • OpenAI
  • Gemini
  • AWS
  • Kubernetes
  • Terraform
  • Datadog
  • Sentry
  • Argo CD
  • PagerDuty
How it works

From a repository to a living architecture

Five things Archyl does for you, starting with your first push.

/ 05

AI discovery

Connect a repo. Get a C4 model.

Archyl reads your code, manifests and infrastructure files, and drafts every system, container, component and dependency. You review, approve, done.

  • GitHub, GitLab, Bitbucket, Azure DevOps and more
  • Monorepos and infrastructure as code
  • Nothing is published without your approval

Built for everyone who touches the architecture

One model, four ways to use it.

Architects

Stop redrawing diagrams. Spend your time on decisions, and let discovery and drift checks keep the model honest.

See how

Engineering teams

Find who owns what, what depends on what, and why it was built that way, without asking around.

See how

CTOs and engineering leaders

See the whole estate at a glance, track delivery with DORA metrics, and onboard people in days.

See how

Platform teams

Enforce standards with conformance rules and give every AI agent the same guardrails.

See how
For AI coding agents

The control plane for your coding agents

Archyl is not another coding agent — it sits above the ones you already run. Every work session opens with your architecture, and gives it back before it closes.

01start_work_session

The agent declares the work

Archyl resolves the task against your C4 model, takes advisory leases on the elements involved and returns a preflight gate: allow, warn or deny. The session opens with a briefing — elements in scope, the ADRs that constrain them, guardrails and pitfalls.

02Guard

Guardrails while it codes

On Claude Code, the Guard hook blocks an edit that violates a conformance rule before it is written. Other agents run the same check over MCP.

03remember

What the code cannot show

Agents pin notes, conventions and pitfalls onto the elements they touched, so the next session starts where this one ended.

04finish_work_session

An honest outcome

Summary, decisions and follow-ups are written back to the architecture. When the architecture moved, an Architecture Change Request opens: agents propose, humans merge.

The model stays current

Every session gives back more than it took. Your architecture stops rotting behind the code your agents write.

~/acme/commerce-platform — claudeharness on
Claude Code · Archyl MCP connected · 191 tools
> add rate limiting to the public API
● archyl · start_work_session(task: "add rate limiting to the public API")
├ gate WARN 1 element held by cursor/marc
├ leases ApiGateway, RateLimiter
├ decision ADR-017 All throttling is enforced at the gateway
>

Works with the agents you already run

Claude CodeCursorCopilotCodexGemini CLI
Read the Harness guideMCP server

One command to install. Available on every plan.

And everything else your architecture needs

Architecture as Code

Define your C4 architecture in a declarative archyl.yaml file. Version-controlled, CI/CD-ready, and fully synced.

DORA Metrics

Track deployment frequency, lead time, MTTR, and change failure rate across your releases and environments.

Organization Collaboration

Work together with your organization on architecture decisions.

Interactive Whiteboards

Sketch ideas, brainstorm architecture, and collaborate visually with your team.

Project Documentation

Write and manage Markdown docs linked directly to your architecture elements.

API Contracts

Import and visualize OpenAPI, GraphQL, gRPC and AsyncAPI specs linked to your C4 model.

Release Management

Track deployments, tag versions, and visualize your release history across systems and environments.

Technology Radar

Map every language, framework, database, and tool across your architecture on an interactive radar with adoption rings and quadrants.

Ownership Map

Visualize team and user ownership across your architecture with interactive bubbles, dependency lines, and coverage tracking.

Managed Agent Runs

Dispatch autonomous AI agents that run on a schedule, connect to GitHub, Linear, Slack via MCP connectors, and work on your codebase with full architectural context.

Git Integration

Connect GitHub, GitLab, or Bitbucket repositories seamlessly.

Explore all features
Chat bot

Plug Archyl into Slack & Teams

Ask in plain language. Get answers grounded in your real architecture. Let it take action — all without leaving the channel.

  • Mention @Archyl in any channel or thread
  • Agentic mode runs live MCP tools — and shows its work
  • Take action: create ADRs, docs and more, from chat
  • Scoped to your org, with the installer's permissions
Read the setup guideAvailable on Business plans and above
#architecturelive
V
Vincent
@Archyl what changed in the Payments system — and log the decision?
Archyl
find_relevant_context
Integrations

Your tools, one dashboard

Connect your observability, CI/CD and code quality tools to Archyl. Get live metrics, deployment status and error tracking right inside your architecture diagrams.

Explore all integrations
datadog
prometheus
pagerduty
sonarqube
kubernetes
newrelic
github
gitlab
argocd
sentry
Archyl
Enterprise

Bring your own AI provider

Route every Archyl AI feature through your own contract — OpenAI, Anthropic, Google Gemini, AWS Bedrock, or any OpenAI-compatible endpoint. Your provider, your key, no Archyl quota.

Read the announcement
OpenAIAnthropicGoogle GeminiAWS Bedrock+7
Get started

From sign-up to a smarter agent in three steps

No migration project, no diagramming marathon. Connect, plug in, invite.

1

Connect a repository

Pick your Git provider. Discovery drafts the C4 model while you grab a coffee.

GitHub
GitLab
BBitbucket
Azure DevOps
2

Plug in your coding agent

One command gives Claude Code, Cursor or any MCP client your architecture.

$ claude mcp add --transport http archyl \
  https://api.archyl.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

3

Bring your team

Invite editors to shape the model and everyone else to read it, for free.

ALAda LovelaceEditor
MDMarc DuboisEditor
KSKenji SatoViewer

Viewers are free. Only editors count as seats.

Frequently asked questions

Everything you need to know about Archyl and architecture documentation.

What is Archyl?

Archyl is an AI-powered architecture documentation platform built around the C4 model. It lets you create interactive diagrams, discover architecture from your codebase using AI, detect drift between documentation and code, and collaborate with your team in real time.

Is Archyl free to use?

Yes. Archyl offers a free Developer plan with unlimited C4 diagrams, AI discovery, architecture decision records, and Architecture as Code. No credit card required. Paid plans add team collaboration, conformance rules, DORA metrics, and enterprise features.

What is the C4 model?

The C4 model is a hierarchical approach to software architecture visualization created by Simon Brown. It uses four levels of abstraction -- System Context, Container, Component, and Code -- to describe your system from a bird's-eye view down to implementation details.

How does AI architecture discovery work?

Connect your Git repository and Archyl's AI analyzes your codebase to automatically discover systems, containers, components, and relationships. It reads your code structure, imports, and configuration to build an accurate C4 model you can review and refine.

What is architecture drift detection?

Drift detection measures how accurately your documented C4 model matches your actual codebase. Archyl computes a deterministic 0-100% health score by checking file paths, directory structure, and element existence. You can enforce minimum thresholds in CI/CD pipelines.

Can AI coding agents use my architecture documentation?

Yes. Archyl provides a built-in MCP server with 191 tools that AI coding agents like Claude Code, Cursor, and VS Code Copilot can use to query your architecture, read ADRs, check conformance rules, and create or update C4 elements through natural conversation.

What integrations does Archyl support?

Archyl integrates with GitHub, GitLab, Slack, Jira, and any MCP-compatible AI tool (Claude Code, Cursor, VS Code, JetBrains IDEs). It also supports webhooks, REST API, and Architecture as Code via archyl.yaml for CI/CD pipeline integration.

How is Archyl different from Structurizr or draw.io?

Unlike static diagramming tools, Archyl keeps documentation alive with AI-powered discovery from code, architecture drift detection, conformance rules, DORA metrics, change request workflows, and a built-in MCP server for AI coding agents. It is a living architecture platform, not just a drawing tool.

Free plan forever

Your architecture, finally up to date

Start free with your first repository. Bring your team when you are ready.

  • No credit card
  • Set up in five minutes
  • Viewers are always free
Book a demoRead the quickstart

Architecture documentation that stays true to your code

Create interactive C4 architecture diagrams, discover architecture from code with AI, and keep docs in sync with Architecture as Code (YAML DSL).

AI-powered C4 discovery

See your whole architecture.

Connect a repo. Archyl maps every system, service, and dependency into an interactive C4 model, then keeps it in sync on every push.

No credit card required

Everything you need to document your architecture

Explore features

C4 Model Visualization

Beautiful, interactive diagrams at every level - from system context to code.

AI-Powered Discovery

Automatically discover and document your architecture from source code.

Connect GitHub, GitLab, or Bitbucket repositories seamlessly.

Keep your documentation in sync as your codebase evolves.

Enterprise Security

SOC 2 Type II in progress. Role-based access control and SSO available today.

Organization Collaboration

Work together with your organization on architecture decisions.

Interactive Whiteboards

Sketch ideas, brainstorm architecture, and collaborate visually with your team.

Project Documentation

Write and manage Markdown docs linked directly to your architecture elements.

Import and visualize OpenAPI, GraphQL, gRPC and AsyncAPI specs linked to your C4 model.

REST, GraphQL, gRPC, AsyncAPI

Release Management

Track deployments, tag versions, and visualize your release history across systems and environments.

Technology Radar

Map every language, framework, database, and tool across your architecture on an interactive radar with adoption rings and quadrants.

Architecture as Code

Define your C4 architecture in a declarative archyl.yaml file. Version-controlled, CI/CD-ready, and fully synced.

Visualize team and user ownership across your architecture with interactive bubbles, dependency lines, and coverage tracking.

Track deployment frequency, lead time, MTTR, and change failure rate across your releases and environments.

Agent Hub & Guardrails

Define architecture conformance rules that AI agents must respect. 169 pre-built guardrails across 23 technologies, plus full architectural context via MCP.

Managed Agent Runs

Dispatch autonomous AI agents that run on a schedule, connect to GitHub, Linear, Slack via MCP connectors, and work on your codebase with full architectural context.

Full architectural context

Architecture Drift Score

Measure how accurately your documentation reflects the actual codebase. A single 0-100% health score, computed in seconds, tracked over time, and enforceable as a CI quality gate.

Frequently asked questions

Everything you need to know about Archyl and architecture documentation.

Archyl is an AI-powered architecture documentation platform built around the C4 model. It lets you create interactive diagrams, discover architecture from your codebase using AI, detect drift between documentation and code, and collaborate with your team in real time.

Is Archyl free to use?

Yes. Archyl offers a free Developer plan with unlimited C4 diagrams, AI discovery, architecture decision records, and Architecture as Code. No credit card required. Paid plans add team collaboration, conformance rules, DORA metrics, and enterprise features.

What is the C4 model?

The C4 model is a hierarchical approach to software architecture visualization created by Simon Brown. It uses four levels of abstraction -- System Context, Container, Component, and Code -- to describe your system from a bird's-eye view down to implementation details.

How does AI architecture discovery work?

Connect your Git repository and Archyl's AI analyzes your codebase to automatically discover systems, containers, components, and relationships. It reads your code structure, imports, and configuration to build an accurate C4 model you can review and refine.

What is architecture drift detection?

Drift detection measures how accurately your documented C4 model matches your actual codebase. Archyl computes a deterministic 0-100% health score by checking file paths, directory structure, and element existence. You can enforce minimum thresholds in CI/CD pipelines.

Can AI coding agents use my architecture documentation?

Yes. Archyl provides a built-in MCP server with 191 tools that AI coding agents like Claude Code, Cursor, and VS Code Copilot can use to query your architecture, read ADRs, check conformance rules, and create or update C4 elements through natural conversation.

What integrations does Archyl support?

Archyl integrates with GitHub, GitLab, Slack, Jira, and any MCP-compatible AI tool (Claude Code, Cursor, VS Code, JetBrains IDEs). It also supports webhooks, REST API, and Architecture as Code via archyl.yaml for CI/CD pipeline integration.

How is Archyl different from Structurizr or draw.io?

Unlike static diagramming tools, Archyl keeps documentation alive with AI-powered discovery from code, architecture drift detection, conformance rules, DORA metrics, change request workflows, and a built-in MCP server for AI coding agents. It is a living architecture platform, not just a drawing tool.

Plug Archyl into

Ask in plain language. Get answers grounded in your real architecture. Let it take action — all without leaving the channel.

Mention @Archyl in any channel or thread

Agentic mode runs live MCP tools — and shows its work

Take action: create ADRs, docs and more, from chat

Scoped to your org, with the installer's permissions