Saropa Workspace

Pin files as shortcuts, run scripts with a double-click, and automate repository workflows.
Developed by Saropa to make Flutter & Dart development faster.

💬 Have feedback on Saropa Workspace? Please share it by opening an issue on GitHub!

Saropa Workspace maps your recurring shell scripts and critical platform configurations into a master sidebar menu. On initialization, it parses your manifests and .git/config to auto-generate Recipes. These are zero-config, one-click macros for tasks like formatting, linting, and tracking Git branch PRs. The true utility is the background automation engine. You can map scripts to specific file globs to execute headless tasks instantly on save. You can chain multiple commands into execution graphs or fire them off cron schedules while the editor is open. The environment state saves directly to a plain .json file inside .vscode/. Commit it, and your whole team inherits a fully automated project workspace without manual onboarding.

Screenshot

Features

📌 Add & Open

• Single-Click Access: Pin any file via the editor title menu or Explorer right-click menu to open it instantly without hunting through directories.
• Website Shortcuts: Add any URL — the project's GitHub page, a staging dashboard, a docs site — with Add Website (URL)...; a single click opens it in your browser, right beside your file and script shortcuts. Or run Add Website Shortcuts from Project... to pick from the addresses your repo already declares (git remote, package.json, pubspec.yaml, mkdocs.yml) in one checklist — no source scanning, just the known files, so the list stays short.
• Scoped Shortcuts: Organize configurations into Project Shortcuts (shared repo-level) or Global Shortcuts (tied to your user profile).
• Unused Marker: Unused or newly added shortcuts carry a leading dot (●) until you open or run them, so new items are easy to spot.
• Launcher Board: Access your tools via a dedicated bottom panel tab with searchable text filters, collapsible sections, and responsive column layouts.

▶️ Script Execution

• Double-Click Runs: Double-click a saved shortcut to trigger scripts inside the integrated terminal or a background channel.
• Custom Environments: Define runtime prefixes (python, node, bash), append CLI arguments, set working directories, and inject environment variables.
• Dynamic Tokens: Parameterize commands with interactive placeholder tokens like ${prompt:Label} or ${pick:a,b,c} that cache your last chosen response.
• Process Handling: Bypasses tree-view event limits with inline play buttons, displays last-run exit status flags, and offers quick force-kill commands.

⏰ Scheduling & Workflows

• Automation Triggers: Run saved scripts at designated times, repeating intervals, open events, or native cron expressions.
• Visual Planner: Wire shortcuts into graph chains or calendar sequences that respond to project hooks like git commits, pushes, or file saves.
• In-Process Engine: Runs lightweight tasks locally without external system configuration; a status-bar tracker keeps queued scripts visible.

🧩 Discovered Recipes

• Auto-Detection: Scans your codebase manifests and .git/config to stand up dynamic macros without manual entry.
• Ecosystem Shortcuts: Generates instant controls for package installs, formatting, lint diagnostics, repository PR paths, and local docker deployment.
• Hygiene Tools: Includes built-in sweeps like a Workspace bloat scan to clear directory conflicts and layout freezes.
• Editable Promotion: Keep scripts hidden, toggle entire recipe domains off, or choose Promote to Shortcut to customize a macro permanently.

Technical Capabilities

• Workspace Management: Group configurations with drag-and-drop support, customize codicons/colors, or swap between isolated tool sets.
• Smart Onboarding: Infers runner profiles automatically for new package.json or Makefile entries, and suggests shortcuts for heavily pinned files.
• Ecosystem Diagnostics: Tracks modification histories via the Project Files pane, calculates code health indexes, and exposes background execution logs.

Project vs Global Scopes

Execution Fallbacks

VS Code trees lack native double-click handling, so the extension monitors click gaps via saropaWorkspace.doubleClickMs (default 400 ms). If click intervals feel erratic on your hardware, use the explicit inline play button or the right-click Run menu for deterministic execution.

Settings Reference (saropaWorkspace.*)

{
  "saropaWorkspace.interpreterDefaults": {
    ".py": "python",
    ".js": "node",
    ".ts": "ts-node",
    ".sh": "bash"
  }
}

Command Reference

Part of the Saropa Suite

Contact & License

• Support: dev@saropa.com
• License: MIT — open usage.

GitHub | Issues | Saropa Suite