README
¶
GenieTerm
GenieTerm is a semantic, remote-native terminal for command blocks, durable sessions, and file workflows.
It is built on top of the Wave Terminal codebase and keeps Wave's strong foundation: durable remote sessions, inline previews, built-in editing, wsh, and cross-platform Electron/Go packaging. GenieTerm's product direction is narrower and more opinionated: make the terminal itself understand command boundaries, status, output, duration, and remote file identity while reusing the same runtime, session, and controller path.
Current Focus
- Warp-style semantic command blocks as the default terminal presentation, with classic xterm as a compatibility mode over the same
TerminalView/TermWrapruntime. - Inline command completion powered by the Fig spec corpus (commands, flags, paths, history).
- A keyless AI command composer (natural language → command) that stays out of the normal workflow.
- A dark-only, Apple-inspired visual identity.
- Remote file and transfer flows that present
genie://identity while preservingwsh://compatibility.
Product Direction
GenieTerm will continue to develop terminal-first remote workflow features around:
- Semantic command blocks with safe gutter, status, duration, copy, and jump affordances.
- Durable local and remote sessions that remain ordinary xterm sessions underneath.
- Remote file inspection, previewing, upload, download, and recovery flows.
- Additive public
genie/genie://aliases that do not break existingwsh/wsh://scripts. - Optional app-builder and AI surfaces kept out of the normal terminal workflow.
Relationship To Wave
GenieTerm is based on Wave Terminal, an Apache-2.0 open-source terminal.
This fork keeps the upstream license and acknowledgements while developing an independent product direction.
Development
Install dependencies:
task init
Run the baseline quality gate before merging release-bound work:
task v1:gate
Run targeted tests for a quick GenieTerm transfer-slice regression:
npm test -- frontend/util/transferutil.test.ts emain/transfer/download-folder.test.ts frontend/util/previewutil.test.ts --run
Build a local macOS package outside File Provider-managed folders:
GENIETERM_BUILD_OUTPUT=/private/tmp/genieterm-make task package
Install the arm64 app locally:
rm -rf /Applications/GenieTerm.app
ditto --norsrc /private/tmp/genieterm-make/mac-arm64/GenieTerm.app /Applications/GenieTerm.app
License
GenieTerm is licensed under Apache-2.0. See LICENSE and ACKNOWLEDGEMENTS.md.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
generatego
command
|
|
|
generateschema
command
|
|
|
generatets
command
|
|
|
packfiles
command
|
|
|
server
command
|
|
|
test
command
|
|
|
test-conn
command
|
|
|
test-streammanager
command
|
|
|
testai
command
|
|
|
testopenai
command
|
|
|
testsummarize
command
|
|
|
wsh
command
|
|
|
pkg
|
|
|
aiusechat/codexcompose
Package codexcompose is a self-contained, keyless one-shot text client for the command composer.
|
Package codexcompose is a self-contained, keyless one-shot text client for the command composer. |
|
aiusechat/gemini
Package gemini implements the Google Gemini backend for WaveTerm's AI chat system.
|
Package gemini implements the Google Gemini backend for WaveTerm's AI chat system. |
|
aiusechat/google
Package google provides Google Generative AI integration for WaveTerm.
|
Package google provides Google Generative AI integration for WaveTerm. |
|
baseds
used for shared datastructures
|
used for shared datastructures |
|
genconn
generic connection code (WSL + SSH)
|
generic connection code (WSL + SSH) |
|
ijson
implements incremental json format
|
implements incremental json format |
|
util/iochan
allows for streaming an io.Reader to a channel and an io.Writer from a channel
|
allows for streaming an io.Reader to a channel and an io.Writer from a channel |
|
util/pamparse
Package pamparse provides functions for parsing environment files in the format of /etc/environment, /etc/security/pam_env.conf, and ~/.pam_environment.
|
Package pamparse provides functions for parsing environment files in the format of /etc/environment, /etc/security/pam_env.conf, and ~/.pam_environment. |
|
wcore
wave core application coordinator
|
wave core application coordinator |
|
wps
wave pubsub system
|
wave pubsub system |
|
wshrpc
types and methods for wsh rpc calls
|
types and methods for wsh rpc calls |
|
tsunami
module
|