Home

Build with COG

Start Building in Seconds

Copy-paste recipes for every COG module. Pick a module, follow the quickstart, then explore the full recipe book. Every command runs immediately — zero config, zero dependencies.

Core Engine

Pack, verify, query — the foundation of everything

File: cog.py + cog.sh
Install
curl -fsSL https://cognis.work/install.sh | sudo bash
In plain English

This is the container system at the heart of COG. It lets you package files, track what changed, and prove that nothing was tampered with — like a tamper-evident box with a built-in history log.

Technical view

The core engine is an append-only content-addressed bundle format with SHA-256 block identities, verification, query support, replayable event logs, and compaction for index and storage optimization.

Quick Start

1. Pack a project

Bundle an entire directory into a single .cog file

cog pack ./my-project output.cog

2. Inspect it

List all blocks with their hashes, types, and sizes

cog list output.cog -v

3. Verify integrity

Check every block hash and proof chain

cog verify output.cog

Recipe Book(9 recipes)

Tips

  • Every operation is append-only — you can never lose data
  • Blocks are content-addressed by SHA-256, so identical content is automatically deduped
  • Use cog compact to reclaim space from old blocks
  • The event log tracks WHO did WHAT and WHEN for every operation

All Modules

End-to-End Workflows

Real-world recipes that combine multiple COG modules together. Each workflow is a complete, copy-paste sequence from start to finish.

Cheat Sheet

Core
cog pack DIR OUT
cog list BUNDLE [-v]
cog get BUNDLE HASH
cog put BUNDLE FILE TYPE
cog query BUNDLE "text"
cog fork BUNDLE OUT
cog verify BUNDLE
cog sign BUNDLE --key K
cog embed BUNDLE FILES
cog replay BUNDLE
cog compact BUNDLE [OUT]
cog log BUNDLE [-n N]
AI
cog_ai.py
cog_ai.py "query"
cog_ai.py -v "query"
cog_ai.py --offline
cog_ai.py --serve-openai-local --port 11435
cog_ai.py --direct-ai "query"
cog_ai.py --seed-knowledge
Local AI
cog_tui.py
cog_tui.py --openai-local-url http://127.0.0.1:11435
cog_tui.py --no-openai-local
curl 127.0.0.1:11435/v1/models
Chain
cog_chain.py wallet create --name N
cog_chain.py wallet balance --name N
cog_chain.py mine --wallet N
cog_chain.py tx send --from A --to B --amount N
cog_chain.py contract deploy ...
cog_chain.py info
cog_chain.py explore block N
Sync
cog_sync.py encrypt IN OUT -p KEY
cog_sync.py decrypt IN OUT -p KEY
cog_sync.py export BUNDLE DIR -p KEY
cog_sync.py import IN -o OUT -p KEY
cog_sync.py diff A.cog B.cog
cog_sync.py merge A B OUT
cog_sync.py serve BUNDLE --port N
cog_sync.py pull HOST:PORT OUT
Enterprise
cog_enterprise.py doc create ...
cog_enterprise.py audit log ...
cog_enterprise.py workflow create ...
cog_enterprise.py incident create ...
cog_enterprise.py secret store ...
cog_enterprise.py classify scan ...
cog_enterprise.py kb create ...
cog_enterprise.py report summary
PQC
cog_pqc.py keygen --security N
cog_pqc.py encrypt --pubkey K ...
cog_pqc.py decrypt --privkey K ...
cog_pqc.py sign --privkey K ...
cog_pqc.py verify --pubkey K ...
cog_pqc.py kem-keygen ...
cog_pqc.py cert-create ...
cog_pqc.py benchmark
Script
cogc.py run FILE.cogs
cogc.py vm FILE.cogs
cogc.py hash FILE.cogs
cogc.py ast FILE --out F.dot
cogc.py ast-json FILE.cogs
cogc.py tokens FILE.cogs
cogc.py disasm FILE --dot F.dot
cogc.py run FILE --max-steps N
9
Modules
ready to use
67
Recipes
copy-paste ready
4
Workflows
end-to-end
0
Dependencies
stdlib-only