Skip to content
PawOS Docs

Project Understanding

How PawOS learns the structure of your project before editing it.

Before proposing edits, PawOS can build a real dependency graph and a feature map for a TypeScript/JavaScript project — which files import which, and which files cluster into a coherent feature (a route, its components, its data model).

Note

This is available even on Paw Go — reading and understanding a project never requires the execution entitlement, only applying changes does.

Not implemented

For languages other than TypeScript/JavaScript, PawOS honestly reports "language: unknown" for structural analysis rather than guessing — it can still read and edit the file, just without the dependency-graph-informed context.

How it works

What you see

  • Your task progress, plan review with affected files and proposed changes, permission questions, command output, diffs, test results, previews and the final Work Record.
  • For multi-file work you see the plan, why each step is needed, and Approve, Reject and Revise controls.
  • While work runs you can follow terminal output, running processes, build and test results, and preview screenshots.

What PawOS does

  • PawOS reads your project structure, dependencies and related files before proposing changes.
  • Edits are applied precisely against the current file contents.
  • Checks can include syntax, imports, type checking, linting, builds, tests, running-app health and visual checks, depending on your project.

Permissions

  • Approving a plan records your intent; each edit, overwrite, command, git change, install, system change, connection or deploy still asks for approval.
  • Commands run under clear rules — PawOS is not an unrestricted shell.
  • Diffs you see come from the real changes, never an illustration.

Records

  • Finished coding work shows the files changed, commands run, their results and output, test results, and screenshots when the change is visual.
  • If a check was skipped (for example, the project has no test script), the Work Record says so.
  • A rejected plan makes no changes.

Good to know

  • Deep project analysis is strongest for TypeScript and JavaScript; every language can be edited.