|
1 | 1 | # TurtleTerm |
2 | 2 |
|
3 | | -> They say the world was built on the back of a turtle. TurtleTerm is built on the back of WezTerm. |
| 3 | +> They say the world was built on the back of a turtle. TurtleTerm carries the shell on its back. |
4 | 4 |
|
5 | | -TurtleTerm is the SourceOS policy-aware, agent-addressable terminal workbench built on the WezTerm engine. |
| 5 | +TurtleTerm is the SourceOS policy-aware, agent-addressable terminal workbench for trusted command execution, terminal receipts, agent delegation, and reproducible operator workflows. |
6 | 6 |
|
7 | | -WezTerm remains the credited upstream terminal emulator and multiplexer. TurtleTerm layers SourceOS session contracts, command receipts, policy-aware execution lanes, Matrix/AgentTerm integration, and macOS/Linux packaging on top of that engine. |
| 7 | +TurtleTerm presents its own product surface: TurtleTerm launchers, TurtleTerm profile, TurtleTerm agent gateway, TurtleTerm release artifacts, and TurtleTerm skill manifests. Third-party notices and required license attribution are preserved in the repository license files and release artifacts. |
8 | 8 |
|
9 | 9 | ## Install |
10 | 10 |
|
@@ -40,25 +40,35 @@ curl -fsSL https://raw.githubusercontent.com/SourceOS-Linux/TurtleTerm/main/pack |
40 | 40 |
|
41 | 41 | See `docs/sourceos/INSTALL.md` for full install, profile activation, and validation instructions. |
42 | 42 |
|
| 43 | +## Launch |
| 44 | + |
| 45 | +```bash |
| 46 | +turtleterm |
| 47 | +``` |
| 48 | + |
43 | 49 | ## Commands |
44 | 50 |
|
45 | 51 | ```bash |
46 | 52 | turtle-term paths |
47 | 53 | turtle-term run -- echo hello |
48 | | -sourceos-term paths |
| 54 | +turtle-agentctl --stdio ping |
| 55 | +turtle-tmux panes |
49 | 56 | ``` |
50 | 57 |
|
51 | | -`turtle-term` is the product command. `sourceos-term` remains as a compatibility command for SourceOS contract work. |
52 | | - |
53 | | -## SourceOS additions |
| 58 | +`turtle-term` is the command wrapper. `turtleterm` is the graphical launcher. `sourceos-term` remains available for SourceOS contract compatibility. |
54 | 59 |
|
55 | | -SourceOS-specific docs, profiles, packaging, and sidecar-friendly wrappers live under: |
| 60 | +## Product surfaces |
56 | 61 |
|
57 | | -- `docs/sourceos/` |
58 | | -- `assets/sourceos/` |
59 | | -- `packaging/homebrew/` |
60 | | -- `packaging/scripts/` |
| 62 | +- TurtleTerm graphical launcher |
| 63 | +- TurtleTerm mux launcher |
| 64 | +- TurtleTerm command wrapper |
| 65 | +- TurtleTerm local agent gateway |
| 66 | +- TurtleTerm agent CLI |
| 67 | +- TurtleTerm tmux bridge |
| 68 | +- TurtleTerm skill manifests |
| 69 | +- TurtleTerm turtle icon |
| 70 | +- TurtleTerm release artifacts, manifests, SBOMs, and attestations |
61 | 71 |
|
62 | | -## License and attribution |
| 72 | +## License and notices |
63 | 73 |
|
64 | | -This fork preserves upstream WezTerm attribution and licensing. See `LICENSE.md` for the MIT license and bundled font license notes. |
| 74 | +TurtleTerm is MIT licensed. Required third-party notices are preserved in `LICENSE.md` and release artifacts. |
0 commit comments