winzik/ide/README.md
David Nurdin 5f9b78f058 IDE: a Terminal, Claude in tabs (windows, history), files' local history; CLI apps' screens get raw keys
- Terminal tool window (Alt+F12, desktop): the user's shell in a pseudo-terminal in the project's folder (xterm.js),
  its size follows the window; Windows: cmd.exe / PowerShell on pipes, the line edited in the IDE
- Claude: a tab per conversation, a new one never stops the others; Open in a Window (closing it brings the tab back);
  every conversation kept in .jumphp/history/claude/ (not in git), the History tab reopens them
- Show Local History: a version of a file at each save and when it changed outside the IDE (.jumphp/history/files/),
  Compare / Revert
- External Libraries: a composer install after the project opened adds its packages (the index and the tree list them again)
- Copy Path and every copy of the IDE go through the system's clipboard (the WebView has no navigator.clipboard)
- the mouse's back / forward buttons: Navigate > Back / Forward
- bin/jumphp: php_run gives Docker a terminal when it has one (TTY_FLAGS never had -t: a CLI app's screen got no raw
  keys); `run` without a game: the folder of games/ it is typed in, JUMPHP_GAME, or the only game
- CLI template: the screen uses the terminal's alternate screen (full screen, the terminal back as it was after)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-03 12:09:52 +01:00

706 B

jumphp/ide

The JumPHP IDE's core (PHP, JumPHP\Ide\) and interface (ui/: HTML / CSS / JS with Monaco), shared by the desktop app (games/ide) and the web IDE of jumphp.net. Documentation: docs/ide.md.

tools/fetch-vendor.sh                    # Monaco and xterm.js into ui/vendor/ (not in git)
bin/jumphp php ide vendor/bin/phpunit    # from the repository root: the core's tests

A host makes new JumPHP\Ide\Ide($workspace, $cacheDir, $emit), calls handle($name, $payload) for the page's commands (a Deferred when the answer comes later), tick() every frame, and serves ui/ with window.JUMPHP_IDE (web) or window.jumphp (desktop) for ui/js/backend.js.