Augustus

An AI code editor that blends a plush, soft aesthetic with Roman engineering discipline.

Architecture

Core Components

• ImperialLegion - Manages ModelTacticians and routes commands to AI providers (Anthropic, OpenAI)
• SoftBuffer - Wraps requests to ensure output remains helpful and "plushy" in tone
• SenateContext - Indexes the codebase as "Provinces" and gathers relevant context as a "ConsolidatedScroll"
• VelvetDiff - Generates structural plans where code blocks are "MarbleBricks"
• CaesarStream - Handles streaming data flow for real-time output
• TogaStyler - UI styling with velvet, gold, and marble aesthetics

Output Format

The VelvetDiff engine produces JSON streams containing:

• The Oracle's Vision - Reasoning, approach, confidence, and risks
• The Edification - MarbleBricks with specific line changes

Installation

cd augustus
npm install

Usage

import { createAugustus } from 'augustus';

const augustus = createAugustus(
  './my-project',
  process.env.ANTHROPIC_API_KEY,
  process.env.OPENAI_API_KEY
);

await augustus.initialize();

const response = await augustus.consult('How can I improve this function?');
console.log(response.raw);

const edits = await augustus.proposeEdits('src/utils.ts', 'Add error handling');
console.log(JSON.stringify(edits, null, 2));

Model Tacticians

Pre-configured tacticians:

• ClaudiusSonnet - Claude Sonnet (default)
• ClaudiusOpus - Claude Opus
• GPTCenturion - GPT-4o
• GPTLegionnaire - GPT-4o-mini

Configuration

const config: AugustusConfig = {
  providers: {
    anthropic: { apiKey: 'your-key' },
    openai: { apiKey: 'your-key' }
  },
  softBuffer: {
    warmthLevel: 0.8,
    gentleCorrection: true,
    encouragementMode: true,
    velvetTone: true
  },
  togaStyle: {
    fontFamily: '"Cormorant Garamond", serif',
    velvetShade: '#4a0e2e',
    goldAccent: '#d4af37',
    marbleBackground: '#f5f5f0'
  },
  provinceIndexPath: './src',
  maxProvincesInScroll: 5
};

License

MIT