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 — zero-config, one-click macros for tasks like formatting, linting, and tracking Git branch PRs. Wire shortcuts into chains and event-driven sequences in the Visual Planner, or fire them off cron schedules while the editor is open. The environment state saves directly to a plain .json file inside .saropa/. Commit it, and your whole team inherits a fully automated project workspace.

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 and pushes.
• 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, and repository PR paths.
• 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.
• Project Files Pane: Surfaces notable files scanned from the open project, with file-type icons/colors and modification-time tracking.
• Dashboard: A process-monitor webview with analytics and trend tabs for background-run activity, alongside the script output it tracks.

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.*)

A representative sample below — open Settings → Extensions → Saropa Workspace (or search saropaWorkspace. in the Settings UI) for the complete, current list.

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

Command Reference

A representative sample below — open the Command Palette and type Saropa Workspace: for the complete, current list.

Part of the Saropa Suite

Contact & License

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

GitHub | Issues | Saropa Suite