Installation & Operations
Everything you need to set up the robust environment for AI agents, ensure IDE compatibility, and operate the workspace safely.
System Requirements
PARA Workspace v1.6.5 is well-tested on Linux and Windows (Git Bash) environments. Below is the tested IDE compatibility matrix for AI agents using the workspace context.
| Platform | Integration Point | Status | Notes |
|---|---|---|---|
| Google Antigravity | .agent/ (skills, workflows) | ✅ Verified | Designed and tested for this platform |
| Claude Code | CLAUDE.md + .agent/ | ⚪ Untested | May read `.agent/rules/` directly — needs validation |
| Cursor | .cursor/rules/ | ⚪ Untested | Theory: copy rules to `.cursor/rules/` |
| VS Code + Copilot | .github/copilot-instructions | ⚪ Untested | Theory: instructions only, no auto-trigger |
Installation Steps
Clone Framework
Clone the repo into Resources (reference source, not a user project).
git clone https://github.com/pageel/para-workspace.git Resources/references/para-workspace
Set Permissions
Ensure CLI scripts are executable (Linux/macOS only).
chmod +x Resources/references/para-workspace/cli/commands/*.sh
Initialize Workspace
Initialize your workspace with a profile and language parameter.
Selects persona (`dev`, `general`, etc) and documentation language (`en`, `vi`).
Maintenance & Operations
Keep your workspace in sync with the latest framework version using built-in CLI safety guards.
sync para update
v1.6.5 Sync kernel, rules, workflows, and skills from the framework repo to your workspace. Automatically backs up existing files and uses Smart Archive to safely retire obsolete ones.
./para update --dry-run /update in your IDE chat cleaning_services para cleanup
v1.6.5 Purge old rollback sessions, trailing .bak files, and flatten backup directories. Defaults to 5-day retention.