Home

Project Architecture

35 files3 required32 optional

Every File in the COG Ecosystem

A complete map of every file created, required, or generated by the COG project. Each entry includes its installation path, language, size, and a detailed explanation of its purpose and how it fits into the system. Files marked required are needed for the core “cog” command to function; all others are optional modules that extend the ecosystem.

File Tree

📁cog/
└─ 📄cog.py
└─ 📄cog.sh
└─ 📄cog_ai.py
└─ 📄cog_conv.py
└─ 📄cog_tui.py
└─ 📄cog_chain.py
└─ 📄cog_sync.py
└─ 📄cog_enterprise.py
└─ 📄cog_pqc.py
└─ 📄install.sh
└─ 📄install.py
└─ 📄install.ps1
└─ 📄sovereign-install.sh
└─ 📄prefetch.sh
└─ 📄example_rules.json
└─ 📄example_runbook.md
└─ 📄DOCS.md
└─ 📄COG_COMMAND_REFERENCE.md
└─ 📄README.md
└─ 📄bundle.cog
├─ 📁~/.cog/
├─ 📁knowledge/
└─ 📄brain.cog
└─ 📁conversations/
└─ 📄sovereign-cache.cog
├─ 📁cog_lang/
└─ 📄cogc.py
└─ 📄lexer.py
└─ 📄parser.py
└─ 📄interpreter.py
└─ 📄codegen.py
└─ 📄vm.py
└─ 📄viz.py
├─ 📁examples/
└─ 📄*.cogs
├─ 📁website/
├─ 📁src/app/
└─ 📄page.tsx
└─ 📄layout.tsx
└─ 📄globals.css
└─ 📄commands/page.tsx
└─ 📄architecture/page.tsx
├─ 📁public/
└─ 📄*.py, *.sh, *.json, *.md
└─ 📄favicon.svg
└─ 📄netlify.toml
└─ 📄tailwind.config.ts
└─ 📄next.config.js
└─ 📄package.json

Filter by Category

Core Engine

2 files

AI & Knowledge

1 file

Conversational Engine

2 files

Blockchain

1 file

Sync & Sharing

1 file

Enterprise

1 file

Post-Quantum Cryptography

1 file

Installers

3 files

Sovereign Dev Architect

2 files

Examples & Documentation

5 files

Generated Artifacts

3 files

Website

3 files

Website Config

3 files

COG Script Language

7 files

Module Dependency Map

Every COG module depends only on Python 3.8+ stdlib. Modules are independent — install only what you need. The arrows below show integration points, not hard dependencies.

Core (Required)
cog.py

Engine: format, CLI verbs, content-addressing

cog.sh

CLI wrapper → delegates to cog.py

Modules (Optional)
cog_ai.py
AI + knowledge + offline distillation
cog_tui.py
TUI + cog_conv.py conversational engine
cog_chain.py
Blockchain + smart contracts
cog_sync.py
Sync + encryption + P2P mesh
cog_enterprise.py
Enterprise workflows + audit
cog_pqc.py
Post-quantum cryptography
Infrastructure
install.sh
COG + Sovereign unified installer
prefetch.sh
Offline cache + brain.cog seeding
sovereign-install.sh
Standalone dev env provisioner
install.py / .ps1
Cross-platform installers
Generated
*.cog bundles
Data + behavior + proof bundles
brain.cog
AI knowledge base (persistent)
sovereign-cache.cog
Offline install bundle
35
Total Files
in ecosystem
5
Languages
Python, Bash, TS, PS1, JSON
0
Dependencies
stdlib-only (Python modules)
2 files
Min Install
cog.py + cog.sh