AI IDE - Multi-Repo AI Development Environment

"For AI by AI" - An AI-powered IDE where AI agents autonomously code across multiple repositories

🎯 What is AI IDE?

AI IDE is a next-generation development environment that revolutionizes how you work with code. Unlike traditional IDEs where AI merely assists, AI IDE features autonomous AI agents that perform coding tasks across multiple repositories simultaneously.

Key Features

✅ Workspace Management - Organize projects with virtual groupings of repositories ✅ Multi-Repository Management - Work with multiple repos in a single workspace ✅ Autonomous AI Agents - AI writes, refactors, and debugs code independently ✅ Agent Collaboration - Multiple AI agents coordinate via a shared message bridge ✅ Streaming Responses - Real-time feedback as AI works ✅ Git Integration - Stage, commit, and push directly from the IDE ✅ Session Persistence - All workspace data encrypted and saved automatically ✅ Smart Search - Find workspaces by name, description, or tags ✅ Modern UI - Beautiful blue-themed interface with Monaco editor ✅ File Watching - Auto-refresh file tree when files change externally ✅ Voice Input - Push-to-talk voice input with OpenAI Whisper ✅ Terminal Integration - Built-in terminal with xterm.js ✅ Quick Open - Fuzzy search files with Cmd/Ctrl+P ✅ Global Search - Search across all files with Cmd/Ctrl+Shift+F ✅ Find & Replace - Find and replace across all files with Cmd/Ctrl+Shift+H ✅ Recent Files - Quick access to recently opened files with Cmd/Ctrl+E ✅ AI Context Menu - Right-click code to explain, refactor, fix, comment, or optimize ✅ Test Runner - Run tests with integrated results display ✅ Screen Recording - Built-in screen capture for creating tutorials and demos ✅ Line Navigation - Jump to specific lines from search results ✅ High Performance - Virtual scrolling, lazy loading, and React optimizations ✅ Logging System - Built-in logging with log viewer for debugging ✅ Production Ready - DevTools disabled, error handling, security hardening

🚀 Quick Start

Prerequisites

Node.js 18+ and npm
Anthropic API Key (Get one here)
Git installed on your system

Installation

Clone the repository

git clone https://github.com/sandeepuppalapati/project-ka.git
cd project-ka

Install dependencies
```
npm install
```

Set up your API key

Create a .env file in the root directory:

ANTHROPIC_API_KEY=your_api_key_here
ANTHROPIC_MODEL=claude-sonnet-4-20250514

Run the application
```
npm run dev
```

The IDE will launch in development mode with hot reloading enabled.

📖 How It Works

1. Create or Open a Workspace

On first launch, you'll see a welcome screen where you can:

Create a new workspace - Give it a name, description, and optional tags
Open an existing workspace - Select from your list of workspaces
Search workspaces - Filter by name, description, or tags

All workspace data (repos, chats, settings) is encrypted and stored locally.

2. Add Repositories

Click the "Manage Repos" button to add local repositories to your workspace. You can add multiple repos and work with them simultaneously. Each workspace maintains its own set of repositories.

3. Chat with AI Agents

Bridge Tab: Coordinate between multiple AI agents working on different repos (workspace-specific)
Repo Tabs: Each repository gets its own AI agent with repo-specific context
All chat history is saved per workspace and persists across sessions

4. AI Does the Work

Give natural language commands:

"Add user authentication to the API"
"Fix the bug in the checkout flow"
"Refactor the database layer to use TypeORM"

The AI agent will:

Read relevant files
Execute commands as needed
Write/modify code
Provide explanations and updates

5. Review & Commit

View changes in the file tree (modified files highlighted)
Stage files in the Git panel
Write commit messages and push to remote

6. Switch Workspaces

Click the workspace selector in the header to switch between workspaces. Each workspace remembers:

Open files and cursor positions
Expanded folders in the file tree
Chat history with AI agents
UI layout preferences

🎨 Interface Overview

┌─────────────────────────────────────────────────────────────┐
│  [⚡ My Workspace ▼] [Edit] [Manage Repos]    [⚙️ Settings] │
├──────────┬──────────────────────┬───────────────────────────┤
│          │                      │                           │
│  File    │   Code Editor        │    Chat with AI           │
│  Tree    │   (Monaco)           │    ┌─────────────────┐   │
│          │                      │    │ Bridge  │ Repo1 │   │
│  📁 repo1│                      │    └─────────────────┘   │
│  📁 repo2│                      │    [Chat Messages]        │
│          │                      │    [Bridge Activity]      │
│          │                      │    [Input Area]           │
│  Git     │                      │                           │
│  Panel   │                      │                           │
└──────────┴──────────────────────┴───────────────────────────┘

⌨️ Keyboard Shortcuts

Shortcut	Action
`Cmd/Ctrl + Enter`	Send message
`Cmd/Ctrl + K`	Focus chat input
`Cmd/Ctrl + B`	Toggle sidebar
`Cmd/Ctrl + /`	Show shortcuts modal
`Escape`	Cancel operation

🏗️ Architecture

Technology Stack

Frontend: React 18 + TypeScript
Desktop: Electron 34
Editor: Monaco Editor
Git: isomorphic-git
AI: Anthropic Claude API (Sonnet 4)
Build: Vite + TypeScript

How AI Agents Work

AI agents use Anthropic's Tool Use API to:

read_file - Read file contents
write_file - Create or modify files
execute_command - Run shell commands
post_to_bridge - Communicate with other agents

Agents work autonomously in a multi-step loop:

Receive task from user
Plan approach
Use tools to gather info and make changes
Verify results
Report completion

🔧 Configuration

API Settings

You can configure your AI settings in two ways:

Environment Variables (.env file)

ANTHROPIC_API_KEY=your_key
ANTHROPIC_MODEL=claude-sonnet-4-20250514

Settings Panel (⚙️ button in header)
- Update Anthropic API key
- Switch between Claude models
- Configure OpenAI API key (for voice input)
- Adjust log level (debug, info, warn, error)
- View, download, and clear application logs
- Settings persist globally across all workspaces

Model Options

claude-sonnet-4-20250514 - Latest and most capable (recommended)
claude-3-5-sonnet-20241022 - Previous generation

Workspace Settings

Configure where workspace data is stored:

Default Path: ~/Documents/ai-ide-workspaces/ (configurable)
Data Storage: All workspace files are encrypted at rest using OS-level encryption
- macOS: Keychain
- Windows: DPAPI
- Linux: Secret Service API / libsecret

🚀 Performance & Logging

Performance Optimizations

AI IDE is optimized for large codebases and long-running sessions:

Virtual Scrolling: Only visible file tree nodes are rendered (react-window)
React Optimizations: Memoization with React.memo, useCallback, useMemo
Lazy Loading: Monaco editor loads only when opening files
Debouncing: Git panel and file watcher refreshes are debounced
Reduced Re-renders: Timer intervals optimized (5s instead of 1s)

Logging System

Built-in logging for debugging and monitoring:

4 Log Levels: debug, info, warn, error (default: error)
File Rotation: Logs kept for 7 days, automatically deleted
Log Viewer: View, search, and download logs from Settings
Performance Metrics: File operations, AI requests, and startup times tracked
JSON Format: Structured logs with timestamps, categories, and metadata

Access logs via Settings → Application Logs section.

📁 Project Structure

ai-ide/
├── src/
│   ├── main/                # Electron main process
│   │   ├── main.ts          # App entry point, IPC handlers
│   │   ├── preload.ts       # Secure IPC bridge
│   │   ├── workspace.ts     # Workspace file operations (encrypted)
│   │   ├── logger.ts        # Logging system with file rotation
│   │   ├── terminal.ts      # Terminal integration with node-pty
│   │   └── fileWatcher.ts   # File watching with chokidar
│   └── renderer/            # React UI
│       ├── components/
│       │   ├── WorkspaceWelcome.tsx
│       │   ├── CreateWorkspace.tsx
│       │   ├── EditWorkspace.tsx
│       │   ├── Settings.tsx
│       │   ├── Terminal.tsx
│       │   └── ...
│       ├── hooks/
│       ├── contexts/
│       │   ├── BridgeContext.tsx
│       │   └── ThemeContext.tsx
│       ├── types/
│       │   ├── workspace.d.ts
│       │   └── electron.d.ts
│       └── App.tsx
├── docs/                    # Design documentation
│   └── WORKSPACE_DESIGN.md  # Workspace architecture
├── dist/                    # Build output
└── package.json

🛠️ Development

Build Commands

# Development mode with hot reload
npm run dev

# Production build
npm run build

# Type checking
npm run type-check

# Run production build
npm start

Development Workflow

Main process (npm run dev:main): Compiles TypeScript and launches Electron
Renderer process (npm run dev:renderer): Vite dev server for React UI
Both run concurrently via npm run dev

🧪 Testing

Test the IDE with a real multi-repo project:

Create a workspace with a descriptive name and tags
Add 2-3 related repositories to the workspace
Ask the AI to make a change that spans repos
Verify the AI coordinates across repos via the Bridge
Test git operations (stage, commit, push)
Switch to another workspace and verify state isolation
Search for workspaces by name or tags

🎯 Roadmap

v0.1-0.3 - Foundation ✅

v0.4 - Workspaces ✅

Workspace creation and management
Encrypted workspace storage
Workspace metadata (description, tags, lastAccessed)
Search and filter workspaces
Edit workspace details
Workspace-specific Bridge chat
State persistence per workspace

v0.5 - Visual Enhancements ✅

Visual diff viewer
File watching & auto-refresh
Workspace deletion with confirmation
Full state persistence (open tabs, file tree state)

v0.6 - Audio & Terminal ✅

Voice input (push-to-talk with OpenAI Whisper)
Terminal integration (xterm.js with node-pty)
Voice recorder UI with waveform

v0.7 - UI Polish ✅

Icon replacement (emojis → Lucide React icons)
Color scheme refresh (teal → soft blue)
Improved visual consistency

v0.8 - Performance ✅

Virtual scrolling for large file trees
React optimizations (memo, useCallback, useMemo)
Timer optimizations (reduced re-renders)
Monaco editor lazy loading
Debounced git panel refresh

v0.9 - Production Hardening ✅

Comprehensive logging system with log viewer
DevTools disabled in production
Performance instrumentation
Dynamic version display from package.json
Error log level default for production

v1.0 - Stable Release ✅ (Current)

Remove redundant localStorage usage
Disk-only storage architecture
Single source of truth for all data
OS-level encryption for sensitive data
Unlimited storage (no localStorage quota limits)
Clean codebase (-290 lines)

v1.1 - Multi-Model Support (Planned)

v1.2 - Analytics & Management (Planned)

Cost tracking dashboard
API usage analytics per workspace
Token usage visualization
Workspace import/export
Search across repos within workspace

Future Versions

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

How to Contribute

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Anthropic for the Claude API and Tool Use capabilities
Monaco Editor team for the excellent code editor
Electron and React communities

📞 Support & Community

Issues: GitHub Issues
Discussions: GitHub Discussions

⚠️ Important Notes

API Costs

AI IDE uses the Anthropic Claude API (bring your own key). Costs vary based on usage:

Sonnet 4: ~$3 per million input tokens, ~$15 per million output tokens
Average session: $0.10-$0.50
Monitor your usage at console.anthropic.com

Security

Never commit your .env file
Keep your API key secure
Review AI-generated code before committing
Use git carefully - AI has full file system access within repos
All workspace data is encrypted at rest using OS-level security
Workspaces are stored locally on your machine only

Built with ❤️ for developers who want AI to do the heavy lifting

Name		Name	Last commit message	Last commit date
Latest commit History 204 Commits
.github		.github
assets		assets
docs		docs
src		src
.env.example		.env.example
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
E2E_TEST_REPORT.md		E2E_TEST_REPORT.md
LICENSE		LICENSE
README.md		README.md
RELEASE_NOTES_v0.1.0.md		RELEASE_NOTES_v0.1.0.md
RELEASE_NOTES_v0.2.0.md		RELEASE_NOTES_v0.2.0.md
RELEASE_NOTES_v0.2.1.md		RELEASE_NOTES_v0.2.1.md
index.html		index.html
notes		notes
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.main.json		tsconfig.main.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

License

sandeepuppalapati/project-ka

Folders and files

Latest commit

History

Repository files navigation

AI IDE - Multi-Repo AI Development Environment

🎯 What is AI IDE?

Key Features

🚀 Quick Start

Prerequisites

Installation

📖 How It Works

1. Create or Open a Workspace

2. Add Repositories

3. Chat with AI Agents

4. AI Does the Work

5. Review & Commit

6. Switch Workspaces

🎨 Interface Overview

⌨️ Keyboard Shortcuts

🏗️ Architecture

Technology Stack

How AI Agents Work

🔧 Configuration

API Settings

Model Options

Workspace Settings

🚀 Performance & Logging

Performance Optimizations

Logging System

📁 Project Structure

🛠️ Development

Build Commands

Development Workflow

🧪 Testing

🎯 Roadmap

v0.1-0.3 - Foundation ✅

v0.4 - Workspaces ✅

v0.5 - Visual Enhancements ✅

v0.6 - Audio & Terminal ✅

v0.7 - UI Polish ✅

v0.8 - Performance ✅

v0.9 - Production Hardening ✅

v1.0 - Stable Release ✅ (Current)

v1.1 - Multi-Model Support (Planned)

v1.2 - Analytics & Management (Planned)

Future Versions

🤝 Contributing

How to Contribute

📄 License

🙏 Acknowledgments

📞 Support & Community

⚠️ Important Notes

API Costs

Security

About

Topics

Resources

License

Code of conduct

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 22

Packages 0

Uh oh!

Contributors 3

Uh oh!

Languages

Packages