Skip to main content

​
subsystems

Lists the current top-level Python modules in the workspace. Each line of output is tab-separated and contains the module name, file count, and a short notes string. 
python3 -m src.main subsystems [--limit N]

​
Arguments

​
--limit
integer
default:"32"
Maximum number of subsystem entries to display. The list is pre-sorted by file count (most files first) before the limit is applied.

​
Output format

Each row is printed as: 
<name>\t<file_count>\t<notes>
ColumnDescription
nameModule name as it appears on disk (commands.py, assistant, etc.)
file_countNumber of .py files belonging to that module
notesShort annotation. Known modules have curated notes; others read Python port support module

​
What subsystems represent

A subsystem is a top-level Python module inside src/. Single-file modules appear as bare filenames (e.g. main.py). Multi-file packages appear as directory names (e.g. assistant, bootstrap). The set of subsystems mirrors the structure of the original TypeScript source tree.

​
Example

python3 -m src.main subsystems --limit 10

commands.py	1	command backlog metadata
tools.py	1	tool backlog metadata
assistant	4	Python port support module
bootstrap	3	Python port support module
models.py	1	shared dataclasses
main.py	1	CLI entrypoint
query_engine.py	1	port orchestration summary layer
port_manifest.py	1	workspace manifest generation
task.py	1	task-level planning structures
cli	2	Python port support module
Pipe the output through column -t -s $'\t' for aligned columns when reviewing in a terminal.

​
When to use it

Use subsystems to get a concise inventory of modules without the extra detail produced by manifest or summary. It is useful for scripting: because the output is tab-separated, it is easy to consume with awk, cut, or Python’s csv module.

Build docs developers (and LLMs) love

Get started for freeTalk to us