- C 58.5%
- Shell 23.2%
- TypeScript 6.3%
- Python 5.2%
- Roff 4.7%
- Other 2.1%
小明
718b5a76c3OpenSSH sends LANG and LC_* by default, so a session now follows LC_ALL, LC_MESSAGES or LANG when it names English or Chinese, and the server's language otherwise. The suites unset those variables so a developer's locale no longer changes what they see. |
||
|---|---|---|
| .github | ||
| demos | ||
| gateway | ||
| include | ||
| packaging | ||
| scripts | ||
| src | ||
| tests | ||
| .gitignore | ||
| flake.lock | ||
| flake.nix | ||
| install.sh | ||
| LICENSE | ||
| MAINTAINERS | ||
| Makefile | ||
| README.md | ||
| SECURITY.md | ||
| tnt-chat.7 | ||
| tnt-exec.7 | ||
| tnt-message-log.5 | ||
| tnt-module-protocol.7 | ||
| tnt.8 | ||
| tnt.service | ||
| tntctl.1 | ||
TNT
SSH-native terminal chat. One shared room, a Vim-style modal interface, and
anonymous access by default. The server is a single C daemon that speaks SSH
directly, so any ssh client is a full client.
Reference documentation ships as manual pages and is installed with the binaries:
| Page | Covers |
|---|---|
tnt(8) |
server, options, environment, state directory |
tntctl(1) |
control client |
tnt-chat(7) |
interactive terminal interface and keybindings |
tnt-exec(7) |
non-interactive exec commands |
tnt-message-log(5) |
message log format and recovery |
tnt-module-protocol(7) |
tnt.module.v1 module protocol |
Install
Release installer, pinned to a tag (verifies checksums.txt before
installing):
curl -sSL https://raw.githubusercontent.com/m1ngsama/TNT/vX.Y.Z/install.sh | VERSION=vX.Y.Z sh
Replace vX.Y.Z with a tag from
Releases. Omit VERSION to track
the latest release.
From source (needs a C compiler and the libssh development package):
git clone https://github.com/m1ngsama/TNT.git
cd TNT
make
sudo make install
Homebrew, Arch, and Debian packaging live under packaging/.
Run
tnt # listens on 2222
tnt -p 3333 -d /var/lib/tnt
tnt stays in the foreground and does not fork; tnt.service is the systemd
unit (sudo make install-systemd).
Connect
ssh -p 2222 chat.example.com
Any username and any password are accepted, including an empty one. The room is anonymous and unrestricted by design.
Operate
tntctl -p 2222 localhost health
tntctl -p 2222 localhost stats
tntctl -p 2222 localhost tail 20
tntctl accepts only the commands defined by tnt-exec(7) and launches ssh
without a shell. Every exec command also works over a plain
ssh -p 2222 host <command>.
Modules
Modules are external processes that exchange JSON Lines with the server over
stdio. They stay disabled unless TNT_MODULE_PATHS names their directories,
and the core must keep working with all of them off. See
tnt-module-protocol(7), validate a module with scripts/module_check.sh, and
find community modules in
m1ngsama/tnt-modules.
Develop
make # build tnt and tntctl
make test # unit, script, and integration suites
make check # cppcheck and clang-tidy
make asan # AddressSanitizer build
scripts/release_check.sh runs the release preflight. MAINTAINERS maps every
path to an area; scripts/get_maintainer.sh <path> resolves one.
License
MIT. See LICENSE.