systemgen

CLI tool that builds reusable AI context from your stack and turns it into a single prompt you can send to an assistant.

Building with AI works better when the model knows your framework, database, folder layout, and conventions. Re-typing that context for every task wastes time and drifts from how your repo actually works. systemgen captures those choices once as a named profile, then merges them with whatever you want to build next. Profiles can live as TOML (terminal tools) or JSON (IDE assistants), or both.

Install

pip install systemgen

Quick start

systemgen init
# Answer prompts for stack, structure, and conventions; pick TOML, JSON, or both; name the profile.

systemgen gen --profile myapp
# Pick your profile if you omit --profile; choose how to supply the task prompt; then send the result where you need it.

Commands

Run systemgen with no subcommand to open the interactive menu when you have profiles.

Profile formats

Profiles are plain data. TOML suits terminal workflows (e.g. Claude Code, Ollama); JSON suits IDE tooling (e.g. Cursor, Windsurf). Example shape (FastAPI-style), shortened:

TOML (~/.systemgen/profiles/<name>.toml):

[project]
type = "Backend API"
framework = "FastAPI"
language = "python"
language_version = "3.11"

[database]
engine = "PostgreSQL"
orm = "sqlalchemy"
mode = "async"

[auth]
method = "JWT"

JSON (~/.systemgen/profiles/<name>.json):

{
  "project": {
    "type": "Backend API",
    "framework": "FastAPI",
    "language": "python",
    "language_version": "3.11"
  },
  "database": {
    "engine": "PostgreSQL",
    "orm": "sqlalchemy",
    "mode": "async"
  },
  "auth": {
    "method": "JWT"
  }
}

Prompt input options (gen)

After you pick a profile, you choose how to add the task:

If you skip the task text, the next step only offers copy, save to file, or exit (no pipe to Claude/Ollama).

Pipe to (gen)

When you supplied a task prompt, you can send the combined output to:

Profiles are saved to

~/.systemgen/profiles/

Languages and stacks

systemgen is not limited to Python. You pick language (e.g. TypeScript, Dart, Go), framework, database, auth, validation, and folder layout from prompts or templates—use it for APIs, frontends, mobile, or CLIs on whatever stack you use.