Skip to content

docs

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
audits
audits
 
 
dev
dev
 
 
images
images
 
 
plans
plans
 
 
proposals
proposals
 
 
AGENTCARD_DISCOVERY_DEMO.md
AGENTCARD_DISCOVERY_DEMO.md
 
 
AGENT_NATIVE_VCS_CORE_BEHAVIOR.md
AGENT_NATIVE_VCS_CORE_BEHAVIOR.md
 
 
AMBIENT_MODE.md
AMBIENT_MODE.md
 
 
ATTRIBUTION_BENCHMARK.md
ATTRIBUTION_BENCHMARK.md
 
 
AUTH_CREDENTIAL_SOURCES.md
AUTH_CREDENTIAL_SOURCES.md
 
 
AWS_BEDROCK_PROVIDER.md
AWS_BEDROCK_PROVIDER.md
 
 
BROWSER_PROVIDER_PROTOCOL.md
BROWSER_PROVIDER_PROTOCOL.md
 
 
COMPILE_TIME_ISOLATION_REFACTOR.md
COMPILE_TIME_ISOLATION_REFACTOR.md
 
 
CRATE_OWNERSHIP_BOUNDARIES.md
CRATE_OWNERSHIP_BOUNDARIES.md
 
 
DESKTOP2_VISUAL_CHECKLIST.md
DESKTOP2_VISUAL_CHECKLIST.md
 
 
DESKTOP_APP_ARCHITECTURE.md
DESKTOP_APP_ARCHITECTURE.md
 
 
DESKTOP_CODEBASE_ARCHITECTURE.md
DESKTOP_CODEBASE_ARCHITECTURE.md
 
 
DESKTOP_FIRST_PROTOTYPE.md
DESKTOP_FIRST_PROTOTYPE.md
 
 
DESKTOP_SINGLE_SESSION_DESIGN.md
DESKTOP_SINGLE_SESSION_DESIGN.md
 
 
DESKTOP_STABLE_HOST_RELOAD_STARTUP.md
DESKTOP_STABLE_HOST_RELOAD_STARTUP.md
 
 
DESKTOP_SUPERAPP_WORKSPACE.md
DESKTOP_SUPERAPP_WORKSPACE.md
 
 
DISCOVERY_BENCHMARK.md
DISCOVERY_BENCHMARK.md
 
 
DISCOVERY_CONVERSION_ANALYSIS.md
DISCOVERY_CONVERSION_ANALYSIS.md
 
 
DISCOVERY_ELICITATION_SPEC.md
DISCOVERY_ELICITATION_SPEC.md
 
 
FINDING_SLOWNESS.md
FINDING_SLOWNESS.md
 
 
GMAIL_COMPOSIO_BACKEND.md
GMAIL_COMPOSIO_BACKEND.md
 
 
HARNESS_API_AND_DESKTOP_REWRITE.md
HARNESS_API_AND_DESKTOP_REWRITE.md
 
 
HOOKS.md
HOOKS.md
 
 
IOS_APP.md
IOS_APP.md
 
 
KEYMAP_CONFLICTS.md
KEYMAP_CONFLICTS.md
 
 
MEMORY_ARCHITECTURE.md
MEMORY_ARCHITECTURE.md
 
 
MEMORY_BUDGET.md
MEMORY_BUDGET.md
 
 
MEMORY_INCIDENT_RUNBOOK.md
MEMORY_INCIDENT_RUNBOOK.md
 
 
MERMAID_RENDERING_REDESIGN.md
MERMAID_RENDERING_REDESIGN.md
 
 
MESSAGE_VOICE.md
MESSAGE_VOICE.md
 
 
MODULAR_ARCHITECTURE_RFC.md
MODULAR_ARCHITECTURE_RFC.md
 
 
MULTI_SESSION_CLIENT_ARCHITECTURE.md
MULTI_SESSION_CLIENT_ARCHITECTURE.md
 
 
ONBOARDING_SANDBOX.md
ONBOARDING_SANDBOX.md
 
 
OPENRELAY_DISCOVERY_TEST.md
OPENRELAY_DISCOVERY_TEST.md
 
 
PROVIDER_DOCTOR.md
PROVIDER_DOCTOR.md
 
 
README.md
README.md
 
 
REFACTORING.md
REFACTORING.md
 
 
REMOTE_HANDOFF.md
REMOTE_HANDOFF.md
 
 
RENDER_PARITY_ACCEPTANCE_CRITERIA.md
RENDER_PARITY_ACCEPTANCE_CRITERIA.md
 
 
RESUME_BEHAVIOR.md
RESUME_BEHAVIOR.md
 
 
RETENTION_READINESS.md
RETENTION_READINESS.md
 
 
SAFETY_SYSTEM.md
SAFETY_SYSTEM.md
 
 
SECURITY_DEPENDENCIES.md
SECURITY_DEPENDENCIES.md
 
 
SERVER_ARCHITECTURE.md
SERVER_ARCHITECTURE.md
 
 
SHIFT_ENTER.md
SHIFT_ENTER.md
 
 
SOFT_INTERRUPT.md
SOFT_INTERRUPT.md
 
 
SPAWN_HOOK.md
SPAWN_HOOK.md
 
 
SPONSORED_DISCOVERY_SPONSOR_ONBOARDING.md
SPONSORED_DISCOVERY_SPONSOR_ONBOARDING.md
 
 
SWARM_ARCHITECTURE.md
SWARM_ARCHITECTURE.md
 
 
SWARM_TASK_GRAPH.md
SWARM_TASK_GRAPH.md
 
 
TERMINAL_BENCH.md
TERMINAL_BENCH.md
 
 
TERMINAL_CAPABILITIES.md
TERMINAL_CAPABILITIES.md
 
 
TUISTATE_TRAIT_DECOMPOSITION.md
TUISTATE_TRAIT_DECOMPOSITION.md
 
 
TUI_COLOR_CONFIGURATION.md
TUI_COLOR_CONFIGURATION.md
 
 
TUI_TEST_FLAKINESS.md
TUI_TEST_FLAKINESS.md
 
 
WINDOWS.md
WINDOWS.md
 
 
WRAPPERS.md
WRAPPERS.md
 
 
jcode_reddit_dashboard.png
jcode_reddit_dashboard.png
 
 
reddit_dashboard.py
reddit_dashboard.py
 
 

README.md

jcode Docs

Reference documentation for the jcode codebase.

Layout

  • docs/*.md — architecture, feature, and behavior docs (current state of the system).
  • docs/plans/ — forward-looking plans, roadmaps, and TODO trackers. May be partially implemented or stale.
  • docs/audits/ — point-in-time audits and reviews. Historical snapshots, not kept up to date.
  • docs/proposals/ — design proposals not yet committed to.
  • docs/dev/ — developer-facing process and testing notes.

Key entry points

  • Architecture: SERVER_ARCHITECTURE.md, MODULAR_ARCHITECTURE_RFC.md, CRATE_OWNERSHIP_BOUNDARIES.md
  • Swarm: SWARM_ARCHITECTURE.md, SWARM_TASK_GRAPH.md
  • Memory: MEMORY_ARCHITECTURE.md, MEMORY_BUDGET.md, MEMORY_INCIDENT_RUNBOOK.md
  • Refactoring and quality: REFACTORING.md, plans/CODE_QUALITY_10_10_PLAN.md
  • Desktop app: DESKTOP_APP_ARCHITECTURE.md, DESKTOP_CODEBASE_ARCHITECTURE.md
  • Providers: PROVIDER_DOCTOR.md, AWS_BEDROCK_PROVIDER.md
  • Platform: WINDOWS.md, TERMINAL_CAPABILITIES.md

Conventions

  • Docs describing current behavior live at the top level; anything speculative goes in plans/ or proposals/.
  • Prefer updating an existing doc over adding a near-duplicate.
  • Root of the repo should only hold README, CONTRIBUTING, RELEASING, AGENTS, LICENSE, and similar meta files. Put everything else here.