echo

KO | EN

gitlite — search

#proxy #gemini #llm #security #editor #cross-platform #swift #nodejs #javascript #graphql

(★ 9)

Echo is a compiled language implemented in Rust. It uses a single LLVM backend and a Rust-owned runtime for both AOT native binaries and in-process JIT execution.

File Explorer

ZIP Download

- config.toml
- pre-commit
- - bug_report.md
  - config.yml
  - feature_request.md
- - index.html
  - README.md
- - ci.yml
  - pages-redirect.yml
  - pr.yml
- CODEOWNERS
- pull_request_template.md
- README.md
- echo-icon-black-on-white-128.png
- echo-icon-black-on-white-256.png
- echo-icon-black-on-white-32.png
- echo-icon-black-on-white-512.png
- echo-icon-black-on-white-64.png
- echo-icon-white-on-black-128.png
- echo-icon-white-on-black-256.png
- echo-icon-white-on-black-32.png
- echo-icon-white-on-black-512.png
- echo-icon-white-on-black-64.png
- echo-mark-black-1200.png
- echo-mark-black-on-white-1200.png
- echo-mark-black-on-white-1680.png
- echo-mark-black-padded-1680.png
- echo-mark-white-1200.png
- echo-mark-white-on-black-1200.png
- echo-mark-white-on-black-1680.png
- echo-mark-white-padded-1680.png
- echo-mark.svg
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - build.rs
  - Cargo.toml
- - build.rs
  - Cargo.toml
- - 0001-shared-compiler-pipeline.md
  - 0002-llvm-only-execution-backend.md
  - 0003-ast-is-source-shaped.md
  - 0004-rust-runtime-owns-executable-semantics.md
  - 0005-structured-diagnostics-contract.md
  - 0006-closed-compilation-graph.md
  - 0007-docs-vs-www-ownership.md
  - 0008-standalone-language-not-php-superset.md
  - 0009-full-vertical-slices.md
  - 0010-platform-baseline.md
  - 0011-chumsky-parser.md
  - 0012-analysis-product-pipeline.md
  - 0013-tasks-event-loop-leaders.md
  - 0014-modules-packages-paths.md
  - 0015-echo-2026-canonical-edition.md
  - 0016-scope-owned-memory.md
  - 0017-tls-design-only.md
  - 0018-static-aot-scratch-oci.md
  - README.md
- architecture.md
- ci.md
- development-speed.md
- diagnostics.md
- fixtures.md
- glossary.md
- hir.md
- implementation.md
- incremental.md
- install.md
- lexer.md
- llvm.md
- lsp.md
- memory.md
- mir.md
- modules.md
- parser.md
- pipeline.md
- README.md
- reflection.md
- repl.md
- roadmap.md
- runtime-abi.md
- semantics.md
- sota-gaps.md
- stdlib-go-gaps.md
- stdlib.md
- syntax.md
- testing.md
- tree-sitter.md
- - 001_int_add.ast
  - 001_int_add.echo
  - 001_int_add.lex
  - 002_int_float_mix.ast
  - 002_int_float_mix.check
  - 002_int_float_mix.echo
  - 002_int_float_mix.lex
  - 003_bool_cond.ast
  - 003_bool_cond.check
  - 003_bool_cond.echo
  - 003_bool_cond.lex
  - 004_not_callable.ast
  - 004_not_callable.check
  - 004_not_callable.echo
  - 004_not_callable.lex
  - 005_list_elem.ast
  - 005_list_elem.echo
  - 005_list_elem.lex
  - 006_list_mix.ast
  - 006_list_mix.check
  - 006_list_mix.echo
  - 006_list_mix.lex
  - 007_list_count_no_poison.ast
  - 007_list_count_no_poison.echo
  - 007_list_count_no_poison.lex
  - 008_value_ordering.ast
  - 008_value_ordering.check
  - 008_value_ordering.echo
  - 008_value_ordering.lex
- - 001_width.ast
  - 001_width.echo
  - 001_width.lex
  - 002_width_mix.ast
  - 002_width_mix.check
  - 002_width_mix.echo
  - 002_width_mix.lex
  - 003_duration.ast
  - 003_duration.echo
  - 003_duration.lex
  - 004_bytes.ast
  - 004_bytes.echo
  - 004_bytes.lex
  - 005_locator.ast
  - 005_locator.echo
  - 005_locator.lex
  - 006_duration_add.ast
  - 006_duration_add.echo
  - 006_duration_add.lex
- README.md
- - call.echo
  - collatz.echo
  - digits.echo
  - factorial.echo
  - fibonacci.echo
  - fizzbuzz.echo
  - gcd.echo
  - hanoi.echo
  - list.echo
  - power.echo
  - primes.echo
  - README.md
  - search.echo
  - sort.echo
- - config.echo
  - main.echo
  - README.md
  - routes.echo
  - server.echo
  - surface.echo
  - user.echo
  - user_extra.echo
  - users.echo
- - add.echo
  - aes_gcm.echo
  - anon_struct.echo
  - bitwise.echo
  - break_loop.echo
  - bufio_demo.echo
  - bufio_read.echo
  - bytes.echo
  - bytes_from_int.echo
  - bytes_from_str.echo
  - bytes_get.echo
  - bytes_search.echo
  - bytes_slice.echo
  - cli_demo.echo
  - compress_demo.echo
  - const_hash.echo
  - core_surface.echo
  - countdown.echo
  - counter.echo
  - csprng.echo
  - csv_demo.echo
  - duration.echo
  - effect_block.echo
  - else_if.echo
  - eprint.echo
  - eq_deep_id.echo
  - field_fn.echo
  - first_class_fn.echo
  - floats.echo
  - fs.echo
  - fs_append.echo
  - fs_chmod.echo
  - fs_create_temp.echo
  - fs_symlink.echo
  - hash_table.echo
  - hello.echo
  - hex_bin.echo
  - hmac.echo
  - http_chunked.echo
  - http_client_demo.echo
  - if_branch.echo
  - interp.echo
  - json.echo
  - list_assign.echo
  - list_contains.echo
  - list_hof.echo
  - list_ints.echo
  - list_push.echo
  - locator.echo
  - log_kv.echo
  - map.echo
  - map_test.echo
  - match_lit.echo
  - match_multi.echo
  - match_type.echo
  - math.echo
  - math_trig.echo
  - method_chain.echo
  - multi_bind.echo
  - nested_assign.echo
  - nested_fn.echo
  - os.echo
  - os_chdir.echo
  - os_hostname.echo
  - path_demo.echo
  - path_parent.echo
  - path_rel.echo
  - path_walk.echo
  - point.echo
  - process.echo
  - process_capture.echo
  - process_cwd.echo
  - queue.echo
  - random_log_demo.echo
  - range.echo
  - README.md
  - reflect.echo
  - result_err.echo
  - result_ok.echo
  - return_fn.echo
  - return_self.echo
  - set.echo
  - sha512.echo
  - siphash.echo
  - smoke_test.echo
  - stdin.echo
  - store_memory.echo
  - str_debug.echo
  - str_from_bytes.echo
  - str_parse.echo
  - str_search.echo
  - str_text.echo
  - strings.echo
  - struct_defaults.echo
  - sum_list.echo
  - time_day.echo
  - time_mono.echo
  - time_now.echo
  - tls_demo.echo
  - union_return.echo
  - url_demo.echo
  - utf8.echo
  - width_f32.echo
  - width_i32.echo
  - widths.echo
- README.md
- - grammar.js
  - package.json
  - README.md
  - tree-sitter-echo.wasm
  - tree-sitter.json
- - llvm.sh
  - stage-runtime-lib.sh
  - windows-llvm-deps.sh
- build-wasm.sh
- gate
- install-hooks.sh
- install.sh
- uninstall.sh
- - hash_table.echo
  - map.echo
  - queue.echo
  - set.echo
- - gzip.echo
  - zip.echo
- - aes_gcm.echo
  - hmac.echo
  - random.echo
- - base64.echo
  - csv.echo
  - hex.echo
  - utf8.echo
- - dns.echo
  - http.echo
  - http_client.echo
  - request.echo
  - response.echo
  - server.echo
  - tls.echo
  - unix.echo
  - url.echo
- bufio.echo
- bytes.echo
- cli.echo
- fs.echo
- git.echo
- io.echo
- json.echo
- list.echo
- log.echo
- math.echo
- os.echo
- path.echo
- process.echo
- random.echo
- README.md
- reflect.echo
- store.echo
- str.echo
- test.echo
- time.echo
- - 404.html
  - _headers
  - _redirects
  - CNAME
  - logo.svg
  - robots.txt
- - book-intro.echo
  - hero.echo
- - sync-tree-sitter.mjs
  - verify-docs-pages.mjs
  - verify-prose.mjs
  - verify-sitemap.mjs
  - verify-spa-redirects.mjs
  - verify-static-dist.mjs
  - verify-std-reference.mjs
  - verify-try.mjs
- - app.tsx
  - index.css
  - install.tsx
  - legal.tsx
  - main.tsx
  - router.tsx
  - security.tsx
  - try.tsx
  - vite-env.d.ts
- .gitignore
- .prettierignore
- index.html
- package-lock.json
- package.json
- README.md
- SITE.md
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
.gitignore
AGENTS.md
Cargo.lock
Cargo.toml
CLA.md
CONTRIBUTING.md
justfile
LICENSE
README.md
SECURITY.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Echo is a compiled language implemented in Rust. It uses a single LLVM backend
and a Rust-owned runtime for both AOT native binaries and in-process JIT
execution.

The command-line entrypoint is `xo`.

## Status

Echo is early-stage software. The workspace is scaffolded for full vertical
slices (frontend → semantics → IR → codegen → runtime → CLI). Language features
are implemented incrementally with focused proofs.

## Language design (in progress)

**Echo 2026** is the current language edition and canonical public Language Spec
(site `/e26`, ADR [0015](docs/adr/0015-echo-2026-canonical-edition.md)). The
executable contract is the [`echo26/`](echo26/) suite (`e26` runner).

Keyword-free, statement-led core — implementer surface:
[`docs/syntax.md`](docs/syntax.md).

| Tree | Role |
|------|------|
| [`examples/misc/`](examples/misc/) | Tiny **`xo run`** demos (print, loops, lists, result) |
| [`examples/app/`](examples/app/) | HTTP demo + kitchen-sink surface |
| [`examples/algos/`](examples/algos/) | Classic algorithms (factorial, sort, primes, …) |
| [`std/`](std/) | Standard library Echo sources (IO, TCP, HTTP stubs) |

```bash
cargo build -p xo
./target/debug/xo run examples/misc/hello.echo
./target/debug/xo run examples/misc/sum_list.echo ; echo exit:$?
./target/debug/xo check examples/app/surface.echo
```

Track discussion in [`docs/roadmap.md`](docs/roadmap.md).

## Documentation

| Doc | Role |
|-----|------|
| [`AGENTS.md`](AGENTS.md) | Workflow and invariants for humans/agents |
| [`docs/README.md`](docs/README.md) | Full docs map |
| [`docs/architecture.md`](docs/architecture.md) | Pipeline and crate ownership |
| [`docs/glossary.md`](docs/glossary.md) | Shared vocabulary |
| [`docs/development-speed.md`](docs/development-speed.md) | Local tools and gate |
| [`docs/adr/`](docs/adr/) | Architecture decisions |

Layer specs (`docs/syntax.md`, `docs/parser.md`, …) accumulate rules as each
layer lands.

## Workspace

See [`docs/architecture.md`](docs/architecture.md) for crate ownership and the
compilation pipeline.

- Frontend: `echo_source`, `echo_diagnostics`, `echo_syntax`, `echo_lexer`,
  `echo_ast`, `echo_parser`, `echo_semantics`
- IR and backend: `echo_hir`, `echo_mir`, `echo_codegen`, `echo_codegen_abi`,
  `echo_runtime`, `echo_std`
- Project tooling: `echo_index`, `echo_resolver`, `echo_fingerprint`,
  `echo_cache`, `echo_build`, `echo_reflection`, `echo_lsp`
- CLI: `xo`
- Browser check host: `echo_wasm` (`just wasm`, site `/try`)

## Requirements

- Rust with edition 2024 support
- LLVM 22 when codegen is active (inkwell)
- `clang` and `mold` for native link speed
- `sccache` for compile caching
- `cargo-nextest` and `just` for the local gate

See [`docs/development-speed.md`](docs/development-speed.md) for setup and the
edit/test loop.

## Install (user toolchain)

Published builds are **prereleases**. The current tag is
[`v0.0.1-alpha.rc.1`](https://github.com/csfh/echo/releases/tag/v0.0.1-alpha.rc.1)
and ships `xo-linux-x86_64.tar.gz`, `xo-macos-arm64.tar.gz`, and
`xo-windows-x86_64.tar.gz`.
`from-release` with no tag installs the newest published prerelease. Pass a tag
to pin. GitHub `/releases/latest` only resolves a non-prerelease and 404s today.

```bash
curl -fsSL https://raw.githubusercontent.com/csfh/echo/main/scripts/install.sh \
  | bash -s -- from-release

# Pin this tag
# … | bash -s -- from-release v0.0.1-alpha.rc.1
```

From a checkout, build + install under XDG and link `~/.local/bin/xo`:

```bash
./scripts/install.sh              # build from this tree
./scripts/install.sh from-release # newest published prerelease
./scripts/install.sh from-release v0.0.1-alpha.rc.1
./scripts/install.sh upgrade      # new version, keep previous
./scripts/uninstall.sh            # remove toolchain ( --purge also clears $XO_HOME )
./scripts/install.sh doctor
```

Layout and env vars: [`docs/install.md`](docs/install.md).

## Build and test

```bash
cargo check --workspace
scripts/gate changed --list
scripts/gate changed
scripts/gate workspace
just tools
```

`cargo build -p xo` always includes **LSP** and **REPL** (no Cargo features).

### CI

GitHub Actions (`.github/workflows/ci.yml`) release-builds `xo` **only when a
GitHub release is published** — not on push, PR, or bare tags.

| Artifact | Runner |
|----------|--------|
| Linux x86_64 | `ubuntu-24.04` |
| Windows x86_64 | `windows-2022` |
| macOS arm64 | `macos-14` |

The current published tag (`v0.0.1-alpha.rc.1`) attaches `xo-linux-x86_64`,
`xo-macos-arm64`, and `xo-windows-x86_64`. Windows AOT `xo run` is not
first-class yet; the Windows archive is `xo.exe` for check/fmt/lsp/repl.

On Linux, smoke (`cargo test -p xo`, `xo run` hello) and **`scripts/gate echo26`**
(Echo 2026 conformance) are hard gates when that workflow runs.

CLI surface (commands land as the language grows):

```bash
cargo run -p xo -- --help
cargo run -p xo -- lex <file>
cargo run -p xo -- ast <file>
cargo run -p xo -- ir <file>
cargo run -p xo -- run [--jit] <file>
cargo run -p xo -- build <file> -o <out>
cargo run -p xo -- lsp
cargo run -p xo -- repl
```

## Website

The public site is **[https://xo.run](https://xo.run)** (Cloudflare Pages).
Sources live in `www/` of this repository (Vite, React, Tailwind). GitHub Pages
on this repo only redirects to that host; it does not publish `www/`.

```bash
npm --prefix www install
npm --prefix www run dev
npm --prefix www run lint
npm --prefix www run format
npm --prefix www run build
# or
just web-dev
just web-build
scripts/gate web
```

## Contributing

Contributions are welcome. **By contributing, you accept the project CLA**,
which assigns copyright and IP in your contribution to Christoffer Hallas.

- How to contribute: [`CONTRIBUTING.md`](CONTRIBUTING.md)
- Contributor License Agreement: [`CLA.md`](CLA.md)
- Security: [`SECURITY.md`](SECURITY.md)
- Help wanted (broad): [`docs/roadmap.md`](docs/roadmap.md#help-wanted-broad-scope)

Pull requests run a **Linux** gate (build, smoke, `echo26`). Multi-OS release
builds run only when a GitHub Release is published.

## Community

Use common sense and decency. There is no formal code of conduct. We reserve the right to moderate this community to the extent of the law and the policy of the host. Write oss@christofferhallas.com if you need us.

## License

Licensed under the [MIT License](LICENSE).

echo

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README