aradotso/trending-skills/kwcode-local-coding-agent

# Standard install
pip install kwcode
 
# China mirror (faster in mainland)
pip install kwcode -i https://pypi.tuna.tsinghua.edu.cn/simple
 
# Optional: Cross-Encoder search reranking
pip install "kwcode[rerank]"

# Launch interactive REPL
kwcode

# Inside kwcode REPL or as a slash command:
/api default http://localhost:11434/v1 ollama qwen3:8b

/api default https://api.deepseek.com $DEEPSEEK_API_KEY deepseek-coder
/api default https://api.siliconflow.cn/v1 $SILICONFLOW_API_KEY Qwen/Qwen3-8B

export KWCODE_API_BASE=http://localhost:11434/v1
export KWCODE_API_KEY=ollama
export KWCODE_MODEL=qwen3:8b
kwcode

> <natural language task description>

> 修复登录验证失败的问题
> write a FastAPI login endpoint with JWT auth
> refactor calculate_price into smaller functions

> /plan <task description>

> /checkpoint

> /rollback

> /multi task1 ; task2 ; task3          # all parallel
> /multi task1 -> task2 -> task3        # serial chain
> /multi                                # interactive builder

> /multi
  + add docstring to function `add`       (parallel)
  + add docstring to function `sub`       (parallel)
  + >write tests for the modified code    (serial, depends on above two)

# Install SearXNG (requires Docker Desktop running)
kwcode setup-search

> /search <query>       # explicit search inside REPL

kwcode stats            # CLI command (outside REPL)

> /api list                              # show configured endpoints
> /api default <base_url> <key> [model] # set default endpoint
> /api add <name> <base_url> <key>      # add named endpoint
> /api use <name>                        # switch active endpoint

# Project Rules
 
## bugfix
-Always run `pytest tests/` after any fix
-Never modify migration files directly
 
## codegen
-Use `async def` for all new route handlers
-Import order: stdlib → third-party → local
 
## general
-Line length: 88 (black default)
-All new functions must have type hints

Input
  └─► Gate       — classifies task, routes to skill, matches domain knowledge
        └─► Locator    — BM25 keyword recall + AST call-graph expansion (no LLM)
              └─► Generator  — generates only the changed diff, injects SKILL.md
                    └─► Verifier   — syntax check + pytest (deterministic)
                          └─► Debugger   — sys.settrace captures live variable values
                                └─► Reviewer   — LLM checks intent vs actual change

# KWCode detects "bug", "fix", "error", "失败" → routes to BugFix expert
# Inside REPL:
# > fix the KeyError in user_service.py when email is missing

> generate pytest tests for the PaymentProcessor class

from kwcode import KWCodeAgent
agent = KWCodeAgent(
    api_base="http://localhost:11434/v1",
    api_key="ollama",
    model="qwen3:8b",
    project_dir="/path/to/your/project",
)
result = agent.run("fix the login validation bug")
print(result.status)        # "success" | "failed" | "rolled_back"
print(result.files_changed) # list of modified file paths
print(result.patch)         # unified diff string

from kwcode import KWCodeAgent, TaskGraph
agent = KWCodeAgent(model="qwen3:14b", project_dir=".")
graph = TaskGraph()
t1 = graph.add("add type hints to utils.py")
t2 = graph.add("add type hints to models.py")
t3 = graph.add("write tests for typed functions", depends_on=[t1, t2])
results = agent.run_graph(graph)
for task_id, result in results.items():
    print(f"{task_id}: {result.status}")

/api default <your_base_url> <key> <model>   # re-confirm model name matches server

curl http://localhost:11434/v1/models        # Ollama
curl http://localhost:8080/v1/models         # llama.cpp / LM Studio

> /index                    # force re-index project files

## index
-include: ["*.pyx", "*.pxd", "*.proto"]

> /config verifier.test_cmd "python -m pytest tests/ -x"

## verifier
-test_cmd: python -m pytest tests/ -x --tb=short

# Install local SearXNG (requires Docker)
kwcode setup-search
 
# Verify it's running
curl http://localhost:8080/search?q=test&format=json

> /config context.compression_ratio 0.6    # keep 60% of mid-conversation history
> /config locator.max_files 3              # limit files sent to Generator

kwcode stats --flywheel