Most AI coding assistants are either web-only or Electron-heavy. Athlon Agent is different:

• Codex-like chat timeline with tool-call cards, reasoning display, and session history
• Multi-workspace support with file tree, in-app editor (AvalonEdit), and workspace guard
• Native Markdown rendering (MdXaml) with code-block copy, Mermaid offline preview
• Light / dark themes with consistent Indigo accent (theme conventions)

• Shared AgentRuntime: prompt building, streaming, tool dispatch, multi-round loops
• Built-in tools: file_list, file_read, file_write, file_edit, grep_files, glob_files, execute_command
• Sub-agent delegation (call_assistant) with configurable nesting depth
• Long-term memory hooks and context compaction pipeline

• Scheduled tasks — daily, interval, one-shot, or manual; per-task workspace & prompt
• Skills — YAML + Handlebars templates in ~/.athlon-agent/skills/
• MCP — server configuration UI and stdio client foundation
• Velopack packaging — Setup.exe, portable zip, intranet auto-update feed

• API keys encrypted with Windows DPAPI (not plain JSON)
• JSONL audit logs for tool calls and HTTP interactions
• GitHub Actions CI + tag-based releases

Add screenshots to docs/images/ and embed them here — PRs welcome!

_{Native WPF shell · dual themes · scheduled tasks · workspace editor}

• Windows 10/11
• .NET 8 SDK

git clone https://github.com/karsonto/athlon-work.git
cd athlon-work
dotnet run --project src/Athlon.Agent.App/Athlon.Agent.App.csproj

1. Open Settings and set your OpenAI-compatible endpoint, model, and API key.
2. Add a workspace folder the agent can read and edit.
3. Start chatting — the agent will use tools to explore files on demand.

$env:ATHLON_SKIP_LICENSE = "1"
dotnet run --project src/Athlon.Agent.App/Athlon.Agent.App.csproj

flowchart TB
    subgraph UI["Athlon.Agent.App (WPF)"]
        MW[MainWindow / MVVM]
        MD[MarkdownMessageView]
        SCH[SchedulerService]
    end

    subgraph Core["Athlon.Agent.Core"]
        RT[AgentRuntime]
        CMP[Context Compaction]
        MEM[Memory]
    end

    subgraph Infra["Athlon.Agent.Infrastructure"]
        LLM[OpenAI-compatible client]
        TOOLS[Filesystem tools]
        STORE[File storage + DPAPI]
    end

    subgraph Ext["Extensions"]
        SK[Skills]
        MCP[MCP client]
    end

    MW --> RT
    SCH --> RT
    RT --> LLM
    RT --> TOOLS
    RT --> SK
    RT --> MCP
    RT --> CMP
    MW --> STORE

src/
  Athlon.Agent.App/             WPF UI, view models, scheduler, themes
  Athlon.Agent.Core/            Agent runtime, settings, compaction, memory
  Athlon.Agent.Infrastructure/  LLM client, tools, storage, licensing
  Athlon.Agent.Mcp/             MCP client foundation
  Athlon.Agent.Skills/          Skill loading and Handlebars rendering
tests/
  Athlon.Agent.Tests/           xUnit tests

dotnet build Athlon.Agent.slnx
dotnet test Athlon.Agent.slnx

If the app is running and locks output files:

dotnet build src/Athlon.Agent.App/Athlon.Agent.App.csproj -p:OutDir=.\artifacts\verify\out\

dotnet tool install -g vpk --version 0.0.1298
.\build.bat 1.0.0

Outputs under Releases/: AthlonAgent-Setup.exe, portable zip, and update nupkg. See Auto-Update for intranet deployment.

Runtime data lives under %USERPROFILE%\.athlon-agent\:

.athlon-agent/
  config/        settings.json, license.lic
  sessions/      conversation history (JSONL + Markdown)
  skills/        SKILL.md folders
  logs/          Serilog logs
  credentials/   DPAPI-encrypted API keys
  audit/         tool-call audit JSONL

Details: workspace guard, timeouts, and compaction → Context compaction.

{
  "AgentTurn": {
    "TimeoutMinutes": 120
  }
}

0 = disabled (only manual Stop ends the run). Range: 1–180 minutes.

The client checks an internal HTTP update server (not GitHub directly):

1. Sync Releases/ from a GitHub Release to e.g. https://update.corp.local/athlon-agent/.
2. Configure config/settings.json:

{
  "Update": {
    "Enabled": true,
    "BaseUrl": "https://update.corp.local/athlon-agent"
  }
}

Or set ATHLON_UPDATE_URL. Push a tag to trigger CI release:

git tag v1.0.0
git push origin v1.0.0

Contributions are welcome — whether it's a bug fix, a new tool, UI polish, docs, or tests.

Start here: CONTRIBUTING.md — setup, architecture rules, PR checklist, and commit style.

Quick summary:

1. Fork the repo and create a branch from main
2. Follow existing MVVM / service patterns — keep model logic out of WPF views
3. Read theme & UI conventions before UI changes
4. Run dotnet build and dotnet test before opening a PR
5. Keep persistence file-based via IAppPathProvider (no hardcoded %LocalAppData%)

• Add tests for AppPathProvider, workspace guard, filesystem tools
• MCP server lifecycle: connect, tools/list, tools/call, status UI
• Command execution confirmation dialog
• Session branch management
• Screenshots for the README

• Extend AgentRuntime, AgentEnvironmentPromptBuilder, and tools — not the WPF layer
• UI logic → Athlon.Agent.App/ViewModels/
• Theme colors → palette tokens only; subscribe ThemeChanged when caching brushes
• .pen design files → Pencil MCP tools only

Athlon Agent ships with AD-account-bound license validation for enterprise deployments. Each license is signed (RSA-2048) and tied to a Windows domain account.

License lookup order:

1. license.lic next to Athlon.Agent.App.exe
2. %USERPROFILE%\.athlon-agent\config\license.lic

This is offline signature validation for internal compliance — not DRM. The source code is open for inspection, learning, and contribution; production use in licensed environments requires a valid license file.

• Full MCP server lifecycle (connect, list tools, call, reconnect)
• Command execution confirmation UI
• Session branching
• Richer code-block actions (diff, run)
• Optional code signing in release pipeline
• README screenshots & demo GIF

If you find Athlon Agent useful, star the repo to support the project and help other developers discover it.

_{Built with .NET 8 · WPF · CommunityToolkit.Mvvm · Serilog · MdXaml · Velopack}