Features

Features Overview

Explore everything Astrolabe can do for your development workflow

Astrolabe is packed with features designed to streamline your development workflow. Here's everything you can do:

Core Features

Project Discovery

Auto-Detection

Automatically scan directories and catalog projects by detecting markers like package.json, Cargo.toml, go.mod, etc.

Tech Stack Recognition

Identify languages, frameworks, and package managers. Supports JavaScript/TypeScript, Rust, Python, Go, Java, Ruby, PHP, and more.

Smart Scanning

Configurable scan depth, exclusion patterns, and recursive scanning. Skip irrelevant directories like node_modules and target.

Organization

Folders

Create folders to group related projects. Drag-and-drop projects between folders for easy organization.

Tags

Assign colored tags to projects for flexible categorization. Projects can have multiple tags.

Auto-Organization Rules

Create rules to automatically organize projects based on language, framework, name patterns, and more.

Git Integration

Status at a Glance

See current branch, clean/dirty status, staged/unstaged files, and ahead/behind commits for all projects.

Branch Management

List, switch, and checkout branches. View local and remote branches with tracking information.

Basic Operations

Pull, push, stage all, commit, and checkout branches without leaving Astrolabe.

Project Insights

Disk Usage

See total project size, node_modules size, and build cache size. Identify space hogs instantly.

Last Commit Info

View the latest commit hash, message, date, and author for each project.

Quick Cleanup

Delete node_modules, clear build caches (.next, dist, target), and preview recoverable space.

Terminal Integration

Embedded Terminal

Full-featured terminal powered by Ghostty (WASM). No need to switch to external terminal apps.

Multi-Tab Sessions

Open multiple terminal tabs for different projects or tasks. Each tab maintains its own session.

Ghostty Config Support

Customize fonts, colors, themes, and behavior using Ghostty configuration files.

Projects Browser

View Modes

Switch between Grid, List, and Table views to match your workflow.

Fuzzy Search

Fast, fuzzy search across project names. Find projects instantly with Cmd/Ctrl+F.

Advanced Filters

Filter by language, framework, git status, folder, tags, and more. Combine filters for precise results.

Sorting Options

Sort by name, language, framework, last modified date, or custom order within folders.

Bulk Operations

Select multiple projects and perform batch actions like moving to folder, adding tags, or deleting.

Platform Integrations (Planned v0.4.0)

Connect Astrolabe to your favorite platforms and manage everything from one dashboard:

Vercel

View projects, deployments, logs, environment variables, domains, and rollback deployments.

Cloudflare Pages

Monitor deployments, preview URLs, environment variables, and Workers status.

Netlify

Track sites, deploys, build logs, forms, functions, and bandwidth usage.

GitHub

See repos, pull requests, issues, Actions status, and workflow logs.

Railway

Manage services, deployments, databases, and view usage metrics.

Fly.io

Monitor apps, machines, secrets, regions, and scaling configuration.

Quick Actions

Open in Editor

Launch projects in VS Code, Cursor, or your preferred editor with one click.

Open in File Manager

Jump to project directory in Finder (macOS), Explorer (Windows), or Nautilus (Linux).

Command Palette

Press Cmd+K (Ctrl+K) to access all commands via keyboard. No mouse required.

Keyboard Shortcuts

Navigate and control Astrolabe entirely with keyboard shortcuts. Learn shortcuts in Settings.

Dashboard & Stats

Dashboard Overview

See project count, total disk usage, git repos, and projects needing attention.

Needs Attention

Automatically surfaces projects with uncommitted changes, untracked files, or other issues.

Advanced Features

Process Management

Dev Server Management

Start, stop, and monitor development processes for each project.

Process Output

View real-time stdout/stderr output from running processes.

Auto-Stop

Processes automatically stop when Astrolabe closes to prevent orphaned processes.

Database & Data

SQLite Storage

All data stored locally in a SQLite database. Fast queries and zero cloud dependencies.

Metadata Caching

Project insights and git information cached for instant access.

Export & Backup

Export your database or individual project data for backup or migration.

Performance

Astrolabe is built for speed and efficiency:

  • Native Performance: Rust backend delivers near-instant operations
  • Efficient Scanning: Multi-threaded scanning processes thousands of projects quickly
  • Lazy Loading: Only load data when needed to keep memory usage low
  • Optimized Queries: Indexed SQLite queries for sub-millisecond lookups

Security & Privacy

  • Local-First: All data stored locally. No cloud sync or tracking.
  • API Keys Secured: Platform credentials stored securely in the OS keychain
  • No Telemetry: Astrolabe doesn't collect or transmit usage data

Feature Roadmap

Upcoming features in development:

  • Dependency Audits (v0.5.0) - Scan for outdated or vulnerable dependencies
  • Project Templates (v0.6.0) - Create new projects from templates
  • Global Hotkeys (v0.6.0) - Trigger actions from anywhere with keyboard shortcuts
  • Workflow Automation (v0.6.0) - Chain commands into reusable workflows
  • Activity Tracking (v0.7.0) - Analytics on project activity and build times

See the Roadmap for the full development plan.