JarvisOS: Core Overview

JarvisOS is a lightweight Markdown-first memory workflow designed for OpenAI Codex to solve context loss in AI-assisted project development. Its core goals are:

1. Persistent project notes stored as structured Markdown
2. Seamless new session handover without repeated explanations
3. Low token consumption via optimized document structures

Inspired by human developers' reliance on READMEs and CHANGELOGs, it formalizes this pattern for AI assistants.

Background: Context Loss Pain Points

When using AI coding assistants like Codex, a major issue is context loss—each new session requires re-explaining project background, tech stack, code structure, and progress. Traditional solutions have critical flaws:

• Screenshots: Limited information (visible area only), high token cost (visual processing), poor searchability and editability.
• Background agents: Complex architecture (needs backend services), high token consumption (continuous context maintenance), privacy risks (dependent on third-party services), offline unavailable.

Core Design Principles & Workflow

Design Principles

1. Markdown-first: Readable by humans/AI, version control-friendly, rich tooling, long-term compatibility.
2. Structured but flexible: Recommended docs (PROJECT.md, SESSION.md, DECISIONS.md, PROGRESS.md, CONTEXT.md) with user-customizable options.
3. Incremental update: Layered context (base layer: stable background; active layer: dynamic session info), on-demand loading, smart summaries.

Workflow

• Initialization: Set up project structure (e.g., .jarvis/ folder with templates).
• Development: Session start (load PROJECT/PROGRESS/previous SESSION docs), ongoing (update SESSION/DECISIONS/PROGRESS), end (summarize progress and next steps).
• Handover: Fast recovery via key docs (hundreds to thousands of tokens), consistent state (no hallucinations), parallel work via Git.

Technical Implementation Details

Document Format Specs

• Frontmatter: Metadata like created/updated dates, session ID, token count.
• Status tags: [ACTIVE]/[DONE]/[BLOCKED] for tasks.
• Code references: REF: src/file.ts#Lx-y for key code snippets.

Smart Loading Strategy

• Relevance scoring for task-specific content.
• Layered summaries (one-sentence → paragraph → full content).
• Lazy loading (initial summary only, detailed content on demand).
• Cache for frequently used sections.

Codex Integration

• Optimized system prompts to guide Codex using memory docs.
• Tool calls for automatic document read/update.
• Workspace awareness to locate relevant docs.

Evidence: Comparisons & Real Cases

vs Traditional Solutions

Screenshots

Dimension	Screenshot	JarvisOS
Info Integrity	Limited	Complete
Token Cost	High	Low
Searchability	Poor	Excellent
Version Control	Hard	Native
Editability	Poor	Excellent

Background Agents

Dimension	Background Agent	JarvisOS
Complexity	High	Low
Token Cost	High	Low
Privacy	Dependent	Local
Reliability	Network-dependent	Offline
Cost	Subscription	Free

Real Cases

1. Long-term project: 50+ sessions → 15min→2min start time, 70% token reduction, 80% fewer context errors.
2. Multi-dev collaboration: Git-synced docs → consistent team认知, fast onboarding for new members.
3. Complex refactoring: DECISIONS.md tracks reasons, PROGRESS.md avoids omissions, precise state recovery.

Usage & Best Practices

Getting Started

• Install: Clone template repo and copy to project.
• Init: Dialogue with Codex (e.g., "Initialize JarvisOS for Python FastAPI/PostgreSQL project").
• Daily Use: Session start (load memory), ongoing (update docs), end (summarize progress).

Best Practices

• Document Maintenance: Weekly cleanup, keep docs under 2000 tokens, cross-reference, use Git.
• Token Optimization: Summary first, layered content, avoid repetition via references.

Conclusion & Future Outlook

JarvisOS represents a new AI-human collaboration paradigm:

• From volatile dialogue context to persistent structured docs.
• From AI guesses to human-confirmed facts.
• From token consumption to knowledge accumulation.

Future prospects:

• Standard practice for AI coding assistants.
• Evolution to general collaboration protocol for writing, design, research.

It provides actionable best practices for Codex users to enhance project continuity and reduce token costs.