pychivalry

mcp
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Crusader Kings 3 modding support for VS Code and AI agents: checks grounded in the game itself, a command-line checker and an agent server (MCP). Being rebuilt from the ground up.

README.md

pychivalry

pychivalry tells a Crusader Kings 3 modder, and any AI agent working on a mod, what the game
itself would say about their script, and helps them write script the game accepts. It is a
VS Code extension with a language server, a command-line checker and an agent server (MCP),
all built on one core that takes its CK3 vocabulary only from a spec package derived from the
game.

State of the rebuild

pychivalry is being rebuilt from the ground up in TypeScript. Nothing usable is built yet.

  • What is being built, and why: docs/MVP.md.
  • How, step by step, and how far it has got: docs/PLAN.md (the Progress table).
  • Build step 1, the repository skeleton, is in place: the workspace, task ci, public CI on
    Linux and Windows, the spec package and its check, the record format, the pinned test mods,
    the 2.3.0 speed baselines, and the documents every later step fills.
  • Every document, and which step writes it: docs/README.md. The sources
    pychivalry draws on: docs/references/. What the tests run on:
    docs/test-data.md. The user guide so far:
    docs/guide/.
  • Release 2.3.0, the last version of the old code, lives unchanged in legacy/ and
    still builds from inside that folder. It is the behaviour to match and a source of test data;
    no code is copied from it. It is published as the ck3-language-support extension; the
    rebuild ships as a new extension, pychivalry, starting at 1.0.0.

Building

Needs Node 22 (22.13 or later) and Task.

task ci        # install, build, lint, format check, tests, spec and record checks
task --list    # every task

task ci needs no display, no game files, no model and no key. The suites that read the game
and the test mods run locally; see AGENTS.md.

Layout

packages/core     parse, index, check, lookup, format, fix data; no dependencies
packages/cli      command line
packages/mcp      agent server
packages/lsp      language server
packages/vscode   the extension
tools/            the scripts behind the local tasks
spec/             the committed spec package, its checksum and schema
records/          committed results of the suites that need game files
fixtures/         hand-written test mods, game stubs and the planted-defect mod
docs/             MVP and plan, decision log, references, test data, user guide, wiki source
legacy/           release 2.3.0, unchanged

Contributing

How to report a problem or propose a change: CONTRIBUTING.md. Rules for
working on the code: AGENTS.md. Reporting a vulnerability:
SECURITY.md.

Licence

Apache-2.0; see LICENSE.

Reviews (0)

No results found