Local Workspaces and Data Boundaries

Keep project files local, back them up, and know when an action sends data online.

Windows 2.0.2 and later open My PC projects from Windows folders, with no WSL or device licence requirement. Editing, saving and Free local tools, including local Git, work without sign-in; sign in for AI, Cloud projects, remote Git and account services. Recover an older WSL project with its original owner before copying it; preserve hashes, case-sensitive names, links and unresolved work.

Overview

Start with a local workspace when RTL, instruction-set source, verification inputs, tool licences, or attached hardware must remain on your machine. A website or product sign-in does not by itself upload the contents of a local project.

Desktop Workspaces

Digital Design Studio opens a project directory that you select. Keep the project in a location you control and review the path before running a tool action.

ISA views use the same selected project and the capabilities supplied by the Digital Design Studio host. Save source and intentional exports inside your project. The hidden data workspace of an older standalone ISA app is legacy storage, not the new shared project or a portable repository.

CLI Workspace

After verified installation, alti ide workspace reads, searches, and authors saved files in the explicitly selected Linux project. alti xls and the native engine commands run their documented local operations. Keep project data separate from the installation and extracted archive.

job validate remains an offline source/envelope preflight: it hashes the source without upload, submission, or engine execution. Follow CLI First Success for the distinction between that receipt and an actual CPU XLS result.

Saved-file operations use ide workspace with an explicitly selected local project. Recovery checks use ide workspace health on that same local project. Keep source identities and file hashes with your saved project evidence. See CLI Job and Cloud Commands.

Back Up, Restore, or Move a Workspace

Digital Design Studio

The project is the user-selected directory, so use that entire directory as the backup boundary.

  1. Save open files and close the IDE.

  2. Copy the complete project directory to a separate user-controlled backup location with your normal file manager, backup system, or version-control workflow. Preserve nested files and links rather than copying only the file visible in the editor.

  3. On Windows, open the copy through Local → Projects on this PC → Open project folder. On Linux, use the documented installed launcher.

  4. Confirm the displayed root, open representative source and constraint files, and verify that expected version-control status is present.

  5. Keep the original directory until the copied project passes those checks.

To restore or move the project, copy the verified backup to the destination and open that destination as a new absolute project root. Do not overwrite the only known-good copy while testing the move.

Migrating an older standalone ISA document

An older standalone ISA installation may keep its CX document in application data. Preserve the source explicitly before retiring that installation. The following steps are for recovering that older document, not for opening a separate ISA product in the new workspace.

  1. Save with Ctrl+S and wait for npu.cx · saved in the status bar.

  2. Copy the complete CX text from the editor into a user-controlled .cx file.

  3. Keep any deliberately exported reference or decoder artifacts beside that file, labelled with the application version and date. Those artifacts are evidence, not a full workspace backup.

  4. For a restore or move, first preserve the destination’s current CX text, then paste the saved CX text into the editor, save, and wait for elaboration.

  5. Review diagnostics, instructions, and encoding projections before treating the restored document as usable.

Do not copy hidden application data, credential-store entries, device-trust state, or entitlement files between machines. Workspace content does not carry an account session or licence; complete the sign-in and capability checks required by the destination host. Windows My PC does not require a device licence.

Local and Online Actions

Action

Where data goes

Edit a local desktop project

Project files stay in the selected local workspace

Validate a CLI job offline

The selected source is read and hashed locally; no submission or engine run occurs

Use desktop browser sign-in

Account and licence metadata are exchanged; project source is not implied

Send a prompt with selected project context

The prompt and selected context are sent to the configured AI service

Connect MCP or an external AI provider

Context follows that integration’s authentication and data policy

Local editing uses the selected project folder. Online actions follow the selected service’s authentication and data policy.

Before Sending Project Data

  1. Identify the exact file or directory the action will read.

  2. Identify the service, organization, and project that will receive it.

  3. Check whether the action is released, preview, default-off, or unavailable.

  4. Remove secrets and unrelated source from logs, prompts, and diagnostic bundles.

  5. Keep the returned receipt, job identifier, tool version, and artifact hashes with the project evidence.

If the product does not make the destination or transfer visible, do not assume that the action is safe for restricted project data.

Recover without overwriting newer work

  1. Save or export unsaved editor text separately before restoring files or reconnecting a replaced workspace.

  2. Back up the project source, project settings and needed result artifacts while no writer is changing them. Keep the backup outside the project being repaired.

  3. Restore to a new directory first. Open it explicitly and compare the source and result identities before replacing an existing working copy.

  4. For an interrupted CLI file transaction, use the current installed CLI’s ide workspace health on that same project. Do not delete recovery journals manually.

  5. After reopening the copied project, reread current files. A conflict means another saved version exists; review it before preparing another write.

A Git commit records staged files. It does not include unsaved editor buffers, ignored outputs, personal credentials or every file in a working directory. Review Source control when Git is part of your backup process.

Open the copied project on the right host

  1. On Windows, choose Local → Projects on this PC → Open project folder and select the copy. On Linux, use the documented installed launcher.

  2. Confirm the displayed project root, open a source file, save a harmless change and reopen it.

  3. Keep the original and backup until this check succeeds. Account sessions and tool installations are set up separately on the destination.