Working with AI & IDEs

Get Aexol working with your favorite AI assistant or code editor in under 5 minutes. Choose your setup below.


Setup Options

MethodBest forTimeWhat you get
VS Code ExtensionMost developers, beginners2 minSyntax highlighting, autocomplete, error checking
Spectral AgentInteractive AI coding5 minFull AI agency — reads/writes files, runs commands
Remote MCPAI-powered workflows2 minValidate, generate, and refine via AI assistants
Other IDEsAdvanced users, specific preferences5 minLSP integration for Neovim, Emacs, Sublime

VS Code Extension

Install from marketplace: Search "Aexol" in extensions panel (Cmd+Shift+X).

Once installed, open any .aexol file and you get:


Spectral Agent

The Spectral Agent is a local AI coding agent that reads, writes files, runs shell commands, and searches your codebase — all through natural language.

  1. Install: npm install -g @aexol/spectral
  2. Authenticate: spectral login
  3. Start: spectral serve in your project root
  4. Open Aexol Agent in your browser

Each chat is a session scoped to a project directory. Sessions persist across reloads.


Remote MCP Setup

Point your MCP client to the Aexol backend endpoint. Remote MCP gives your AI assistant the ability to validate Aexol code, generate TypeScript/Python/Rust, and refine artifacts.

Endpoint: https://api.aexol.ai/mcp Auth header: Authorization: Bearer sk-aexol-team-... Methods: initialize, ping, tools/list, tools/call

Client-Specific Instructions

Claude Code:

claude mcp add --transport http aexol https://api.aexol.ai/mcp \
  --header "Authorization: Bearer sk-aexol-team-..."

GitHub Copilot CLI: Use /mcp add interactively, or edit ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "aexol": {
      "type": "http",
      "url": "https://api.aexol.ai/mcp",
      "headers": { "Authorization": "Bearer sk-aexol-team-..." }
    }
  }
}

Claude Desktop — macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Claude Desktop — Windows: %APPDATA%\Claude\claude_desktop_config.json Claude Desktop — Linux: ~/.config/Claude/claude_desktop_config.json

Configure to call backend /mcp with Authorization: Bearer sk-aexol-team-....

Cursor, Windsurf, Cline, Zed, Continue: Configure your MCP integration to target https://api.aexol.ai/mcp with Bearer sk-aexol-team-....


What You Can Do

Once set up, ask your AI:

Available Remote MCP Tools

ToolWhat it does
remote_start_inferenceGenerate artifacts (GraphQL, Prisma, routes, frontend, etc.)
remote_get_inference_taskCheck on a running generation task
remote_refine_aexol_contentRefine raw Aexol content
remote_ingest_cloud_documentUpload docs to team knowledge base
remote_cloud_searchSearch team knowledge base
remote_start_fromGenerate Aexol from natural language
remote_set_contextSet default team/project scope

Full tool catalog: API Reference


Other Editors

<details> <summary><strong>Neovim</strong></summary>
require('lspconfig').aexol.setup{
  cmd = { "aexol", "lsp", "--stdio" },
  filetypes = { "aexol" },
}
</details> <details> <summary><strong>Emacs</strong></summary>
(lsp-register-client
 (make-lsp-client :new-connection (lsp-stdio-connection '("aexol" "lsp" "--stdio"))
                  :major-modes '(aexol-mode)
                  :server-id 'aexol))
</details> <details> <summary><strong>Sublime Text</strong></summary>
{
  "clients": {
    "aexol": {
      "enabled": true,
      "command": ["aexol", "lsp", "--stdio"],
      "selector": "source.aexol"
    }
  }
}
</details>

Troubleshooting

ProblemCheck
AI not respondingBackend /mcp reachable? Auth header correct?
VS Code extension not workingReload window (Cmd+Shift+P → "Reload Window")
LSP not startingRun aexol lsp --info to verify installation
401 UnauthorizedUsing a team API key (sk-aexol-team-...), not a user token?

Next Steps