LLM/jrswab axe

What's that?

Official Site: https://github.com/jrswab/axe

Installation

Install

Set config dir first for NAS auto backup.

[System.Environment]::SetEnvironmentVariable('XDG_CONFIG_HOME', "$HOME\Documents\SynologyDrive\11.Environments", 'User')

Reopen Power Shell to take effect.

go install github.com/jrswab/axe@latest
axe config init

Then got this.

....\Documents\SynologyDrive\11.Environments\axe

Set VSCode as Editor for axe

Set environment variable EDITOR as

%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\Code.exe

Reopen PowerShell and execute to verify.

# Varify environment variable
Get-ChildItem Env:EDITOR

Set provider for local model

Then edit config.yoml.

# TODO: need to update
ii $HOME\AppData\Roaming\axe\config.toml

It would be opened by VSCode. Edit section providers.openai.

[providers.openai]
api_key = "sk-have-a-good-key"
base_url = "http://xxx.xxx.xxx.xxx:60000/v1"

Setup Agent

Add agent

axe agents init query
axe agents edit query

model = "openai/google/gemma-4-E4B-qat-a4_0-gguf"

Test agent

axe run query -p "1+1=?"

If it outputs 2, axe is ready to use.

Advanced practices

# i-have-adhd
curl -sSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/SKILL.md -o adhd.md
# modern-go-guidelines
curl -sSL https://raw.githubusercontent.com/JetBrains/go-modern-guidelines/main/SKILL.md -o modern-go.md
# samber/cc-skills-golang
curl -sSL https://raw.githubusercontent.com/samber/cc-skills-golang/main/skills/golang-security/SKILL.md -o go-security.md
curl -sSL https://raw.githubusercontent.com/samber/cc-skills-golang/main/skills/golang-performance/SKILL.md -o go-perf.md

name = "go-developer"
description = "High-efficiency Go developer with gopls & golangci-lint execution capabilities"
model = "anthropic/claude-3-7-sonnet" # 或使用 open-ai/gpt-4o / ollama/qwen2.5-coder

skills = [
  "~/.config/axe/skills/adhd.md",
  "~/.config/axe/skills/modern-go.md",
  "~/.config/axe/skills/go-security.md"
]

system_prompt = """
You are a senior Golang developer.
- You must strictly follow the i-have-adhd format: direct output, step-by-step with time estimates, and ending with a single Next Step.
- Before suggesting any refactoring, check for lint errors using golangci-lint.
- Write modern Go code (Go 1.21+) using standard libraries like `slices`, `cmp`, and proper error wrapping `fmt.Errorf("%w")`.
"""

[mcp_servers.gopls]
command = "gopls-mcp"
args = []

[tools]
file_read = true
file_write = true
bash_exec = true