██████╗ ███████╗██╗ ██╗███████╗ ██████╗ ██████╗ ██████╗ ███████╗ ██╔══██╗██╔════╝██║ ██║██╔════╝██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██║ ██║█████╗ ██║ ██║███████╗██║ ██║ ██║██████╔╝█████╗ ██║ ██║██╔══╝ ╚██╗ ██╔╝╚════██║██║ ██║ ██║██╔═══╝ ██╔══╝ ██████╔╝███████╗ ╚████╔╝ ███████║╚██████╗╚██████╔╝██║ ███████╗ ╚═════╝ ╚══════╝ ╚═══╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚══════╝
Projects-First Developer Workspace for Windows
Primary Desktop App This repository root is the active Windows desktop codebase for DevScope Air. The older
devscope-winimplementation is not the active app and older work remains only in git history or archive folders.
DevScope Air is the main Windows Electron app in this repository. It is built around project discovery, indexed file browsing, project details, file preview and edit flows, Git workflows, assistant sessions, terminal management, app settings, and release update flows from one desktop surface.
The current package is devscope-air-win.
Current package version:
| Feature | Description |
|---|---|
| Project Discovery | Scan a main projects root plus additional folders, detect project types, and keep an indexed search cache for fast project/file lookup. |
| Project Browsing | Browse folders, inspect project details, and preview files or project tree changes without leaving the app shell. |
| Git Productivity | View status, diffs, history, branches, remotes, stashes, tags, commits, push state, and repository setup actions. |
| Assistant Workflows | Run assistant sessions with approvals, user input, attachments, Playground labs, no-lab terminal access, auto-generated chat titles, and project-aware context. |
| Terminal Workspace | Manage live terminal sessions and preview-terminal runs from the dedicated terminals surface; the legacy /tasks route now redirects there. |
| Desktop Updates | Check, download, and install release updates through the built-in updater flow. |
| Settings Surface | Configure appearance, behavior, package runtimes, projects, assistant defaults, Git, terminal preferences, logs, and app metadata. |
graph TD
A[DevScope Air] --> B[Project Discovery]
A --> C[Project Browse and Preview]
A --> D[Git Workflows]
A --> E[Assistant Sessions]
A --> F[Terminals]
A --> G[Desktop Updates]
A --> H[Settings]
B --> B1[Main Projects Folder]
B --> B2[Additional Folders]
B --> B3[Folder and File Indexing]
D --> D1[Status and Diffs]
D --> D2[Commit and Push]
D --> D3[Branches Remotes Tags Stashes]
E --> E1[Approvals and User Input]
E --> E2[Playground Labs and Terminal Access]
E --> E3[Attachments and Context]
DevScope Air intentionally keeps some capability surfaces narrow in this build:
- The assistant runtime is active in Air and is treated as a first-class workflow surface.
- Some historical surfaces still exist only as redirects or settings-gated entry points.
- The app still contains a broad shared tool registry, but not every historical surface is exposed in the current Air UI.
DevScope Air is built with a Windows-first desktop stack:
- Desktop Shell: Electron with
electron-vite - Frontend: React 19 + TypeScript + Tailwind CSS
- Renderer Routing: React Router
- Editor/Preview Tooling: Monaco-based file preview support
- AI Integration: Groq and Google Gemini for commit message generation
- Desktop Packaging:
electron-builder
- Node.js: v18 or higher
- npm: v9 or higher
- Windows 10/11: primary supported target
-
Clone the repository:
git clone https://github.com/justelson/dev_scope.git cd devscope -
Install dependencies:
bun install
bun run devbun run typecheckbun run buildbun run build:winPackaged installers and update metadata are written to dist/releases/v<package-version>/.
Unpacked desktop bundles are written to dist/unpacked/v<package-version>/win-unpacked/.
Use bun run dist:organize to move older flat dist artifacts into that versioned layout.
graph TD
A[Electron Main] --> B[IPC Handlers]
A --> C[Update Manager]
A --> D[Git and Project Integrations]
A --> E[Assistant Runtime]
B --> F[Preload Adapters]
F --> G[Renderer Process]
G --> H[React Pages and UI]
H --> I[Projects]
H --> J[Assistant]
H --> K[Terminals]
H --> L[Settings]
D --> M[Project Discovery]
D --> N[Git Operations]
F --> O[Shared Contracts]
src/main: Electron main process, IPC registration, update logic, Git and project handlers, assistant runtime, and file indexing services.src/preload: renderer bridge adapters and disabled-feature adapters.src/renderer/src: React app shell, pages, layouts, and UI components for projects, assistant, terminals, and settings.src/shared: contracts, shared metrics, and tool-registry definitions.apps/landing/devscope-web: separate landing-site package.
Contributions are welcome, especially around project workflows, Git UX, desktop polish, and Windows-focused developer tooling.
- Fork the project
- Create your branch:
git checkout -b feature/your-change - Commit your changes
- Push the branch
- Open a pull request
- DevScope repository: justelson/dev_scope
- Sparkle design origin: thedogecraft/sparkle
The Sparkle-inspired visual direction used in this repository was originally derived from that Sparkle project, then adapted to DevScope's own product structure and behaviors.
Distributed under the MIT License. See package.json for the current package metadata.
- The repository root is the primary desktop app and release target.
- The landing package has its own README at
apps/landing/devscope-web/README.md. - Historical legacy work remains accessible through git history and archive folders.
Built for Windows developers who want project context and Git workflow in one place.
If you are curious, yes! this was built by a 15 year old, all you need to build is curiousity and motivation.