Skip to content

icodecedd/cortex-space

Repository files navigation

Cortex Space

High-Performance Developer Workspace & Terminal Manager

Instant Terminals. Dynamic Layouts. Keyboard-Driven Workflow.


Tauri React Tailwind CSS Vite TypeScript
Xterm.js Framer Motion Tauri Store License


📊 Project Status

Active Development Version 0.1.0

Under Development — Cortex Space is a local-first, high-fidelity developer workspace and terminal manager designed to replace outdated static terminal configurations with an intuitive, keyboard-driven layout.


📖 Overview

Cortex Space is built for developers to unify their terminal instances, environments, and custom AI agent tools into a fast, fluid, and cohesive workspace.

Key Benefits

  • 🖥️ Advanced Multi-Pane Terminal – Split, resize, and manage infinite terminal panels powered by Xterm.js and Tauri PTY.
  • ⚡ Keyboard-Driven Command Palette – Trigger settings, switch layouts, and search commands with Ctrl/Cmd + K.
  • 🔄 Drag-and-Drop Organization – Rearrange and re-partition terminal trees on the fly using quadrants and ghost previews.
  • 📦 Command Snippets & Placeholders – Save, run, and resolve dynamic parameters in your custom scripts before execution.
  • 🔌 Local Agent Registry – Discover, install, and run AI developer agents directly within custom terminal environments.
  • 🌊 Spring-Physics UI – Fluid animations and spatial cues (Z-axis scale, focus pushback) make window navigation feel extremely premium.

✨ Features by Subsystem

🛠️ Terminal & Workspace Navigation ⚡ Automation & Agent Workflows
Split terminals horizontally/vertically in recursive layouts Create, organize, and reuse multi-step Command Snippets
Drag-and-drop terminal headers (UX Elevator) with live quadrant previews Dynamic {{VAR}} prompt resolver for customizable variables
Directional keyboard shortcuts (Cmd/Ctrl + Opt + Arrows) for fast navigation Real-time Local Port Detection with automatic TCP-liveness checking
Persistent state restoration across app launches (Workspaces, paths, layouts) Environment-Aware Onboarding to scan and configure global CLI agent tools
Settings system for themes, fonts, font-size, and global UI scaling Integration of local and custom AI agents directly in workspace environments

💡 UX Design Note:
Cortex Space is built around keyboard-first, lightning-fast workflows. The entire interface supports directional hotkeys and features tactile micro-interactions (spring physics, Z-axis scaling, and focus pushback) to keep developers in their flow state without losing contextual focus.


🛠 Tech Stack

Tech Stack Overview Includes Tauri/React/TypeScript/Local-Store

Layer Technology Description
Desktop Core Tauri v2, Rust Binds terminal backend execution with OS native APIs and isolates PTY instances.
Frontend React, TypeScript, Vite Drives the interactive GUI, layout rendering, and component lifecycle.
Terminal Engine Xterm.js Renders low-latency, high-performance terminal views with addon support.
Styling & UI Tailwind CSS, Radix UI, Base UI Powers a fluid, unified design system with robust focus states and styling.
Animation Framer Motion Animates transitions, drag gestures, and physics-based spatial interactions.
Storage Tauri Store Plugin Persists user preferences, layouts, snippets, and app states locally.

🚀 Features

✅ Completed

  • Multi-Pane Terminal Engine – High-performance integration of Xterm.js with Tauri-based PTY processes
  • Dynamic Resizable Layouts – Flexible split-pane engine (horizontal/vertical) with recursive nesting and ratio-based resizing
  • Global Command Palette (Ctrl/Cmd + K) – Lightning-fast "Omni-search" for switching workspaces, templates, or executing UI actions
  • Command Snippet Repository – Store, reuse, and bulk-manage commands to execute instantly in focused terminals
  • Snippet Variable Placeholders – Dynamic {{VAR}} placeholders with glassmorphic prompt resolution before execution
  • Automatic Port Detection – Live terminal output parsing for localhost links with TCP-liveness checks
  • Pane Drag-and-Drop (UX Elevator) – Quadrant-based layout re-partitioning with animated ghost overlays
  • Global Settings & Onboarding – Persistent configuration for typography/themes, plus onboarding tool scan for developer agents

🔄 In Progress

  • State Restoration (Deep Persistence) – Auto-serialize and restore all active workspaces, pane trees, and directory paths upon restart
  • Shell Environment Optimization – Auto-detection of default shells (Zsh, Bash, PowerShell) with PATH inheritance
  • Contextual Pane Actions – Hover and shortcut menus to rename, split, or restart terminal instances
  • Resource Sparklines – Integrated CPU/Memory monitors inside pane headers for real-time tracking
  • Hybrid Agent Architecture (Tauri Sidecars) – Bundle default AI agent CLIs as local Tauri sidecars for 100% offline access

🤝 Contributing

We Welcome Contributions

We love collaboration! Here’s how you can contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature-name)
  3. Commit your changes (git commit -m 'Add new feature')
  4. Push to your branch (git push origin feature-name)
  5. Open a Pull Request

📢 Support the project and help improve developer productivity! 📢

Built for Developer Velocity

GitHub Repo stars GitHub forks

© 2026 Cortex Space - Built for Next-Generation Workspaces

About

Cortex Space is a free, open-source spatial development environment that eliminates manual workspace setup

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors