# README.md · lucenx/signaltty

[View on GitCafe](https://git.cafe/lucenx/signaltty/blob/main/README.md)

Repository: [lucenx/signaltty](https://git.cafe/lucenx/signaltty)

Visibility: public

Requested revision: refs/heads/main

Commit: 0910eb58236bf749010023803c5d7a3da81745ef

Blob: b6d7929d9d66c87743f7535a030f66f4207ebad8

Size: 1024 bytes

[Immutable source](https://git.cafe/lucenx/signaltty/blob/0910eb58236bf749010023803c5d7a3da81745ef/README.md?format=markdown)

````
# signaltty

signaltty is a Linux workspace for coding agents. The project is early. A session server owns the terminals. The command line and the GTK window attach to that server. Closing the window leaves those terminals running.

![signaltty window with one workspace and a shell](docs/images/window.png)

## Build and open

You need Rust 1.92 or newer, GTK 4, libadwaita 1.7, and VTE. On Ubuntu, install `libgtk-4-dev`, `libadwaita-1-dev`, and `libvte-2.91-gtk4-dev`.

```bash
cargo build --workspace
./target/debug/signaltty daemon
./target/debug/signaltty-gui
```

`signaltty new --cwd ~/code/project` opens a shell in that directory. To start an agent there, put the program after `--`, as in `signaltty new --cwd ~/code/project -- codex`.

The design docs start at the [architecture index](docs/README.md).

Signaltty's own contributions are licensed under [MIT](LICENSE-MIT) or
[Apache-2.0](LICENSE-APACHE). Incorporated third-party material retains its
licenses; see [third-party notices](THIRD_PARTY_NOTICES.md).

````