Context

Codesoft OS is a personal AI operating system: one private git repo of plain markdown that gives any AI runtime shared context, connections, and procedure.

Core constraint

Two runtimes exist and they do not share capabilities. The markdown repo is the shared substrate. Files must be useful without connectors. Anything that runs unattended needs an API path, not an MCP path. Secrets never live in the repo.

Connections policy

Keep MCP for interactive chat. For anything a scheduled job touches, write a thin endpoint reference in connections/ and hit the API directly — the headless runtime has no connectors and never will.

Open questions