GitHub - missingstudio/eva: An autonomous, multi-tenant, AI-native software factory. · GitHub
/" data-turbo-transient="true" />
Skip to content
Type / to search
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
missingstudio
eva
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>146 Commits<br>146 Commits
.github
.github
cmd/eva
cmd/eva
docs
docs
internal
internal
scripts
scripts
.gitignore
.gitignore
.golangci.yml
.golangci.yml
.goreleaser.yaml
.goreleaser.yaml
AGENTS.md
AGENTS.md
CHANGELOG.md
CHANGELOG.md
CLAUDE.md
CLAUDE.md
CONTEXT.md
CONTEXT.md
LICENSE
LICENSE
Makefile
Makefile
README.md
README.md
go.mod
go.mod
go.sum
go.sum
View all files
Repository files navigation
An autonomous, multi-tenant, AI-native software factory.
Most AI tools tell you what they did. Eva writes it down first. Every question, every<br>answer, every retry, and every token goes to a file on your disk as it happens. What<br>you see on screen is read back out of that file.
Note<br>Eva is early. Today it is a terminal chat client on a carefully built foundation.<br>It cannot read your files, run your tests, or touch your shell — there are no tools<br>yet. Where this goes next.
Install
# Homebrew, on macOS<br>brew install --cask missingstudio/tap/eva
# The install script, on macOS and Linux<br>curl -fsSL https://raw.githubusercontent.com/missingstudio/eva/main/scripts/install.sh | sh
# With the Go toolchain<br>go install github.com/missingstudio/eva/cmd/eva@latest
# From source, with Go 1.26 or newer<br>git clone git@github.com:missingstudio/eva.git && cd eva && go build -o eva ./cmd/eva
The script checks the download against the release checksums before it installs<br>anything. Read scripts/install.sh first if you prefer. Every<br>other path is in how-to/install-eva.md.
Connect a model
Eva talks to Anthropic and OpenAI. Anthropic is the default, so a key is the whole<br>setup:
export ANTHROPIC_API_KEY=sk-ant-...<br>eva
For OpenAI, run eva init and name the provider in ~/.eva/config.toml. A ChatGPT or<br>Codex subscription works too: run eva login, then set auth = "subscription".<br>eva auth status tells you which credential Eva will use. Your key never reaches a<br>settings file, a log, or the history file.
More in connect a provider and<br>use a subscription.
Use it
Command<br>What it does
eva<br>Open the chat
eva -p ""<br>Answer once, print to stdout, exit
eva init<br>Write a starter settings file
eva login<br>Sign in to a subscription
eva auth status<br>Show how Eva will authenticate
eva help<br>Show this list
In the chat, type / for the local commands: /help, /cost, /clear, /model.<br>They never reach a model, so they cost nothing. eva -p exits non-zero when the answer<br>fails, which makes it safe in a pipeline.<br>See scripting.
Settings
eva init writes ~/.eva/config.toml with every option present, commented out, and<br>explained. Eva runs with none of it. A repo can carry .eva/config.toml to share a<br>team's colours and key bindings, and an allow-list stops it from changing anything<br>else. See theme a repository.
Documentation
tutorial/first-run.md<br>Build it, ask one question, read it back
how-to/<br>One guide per task
reference/commands.md<br>Every command, flag, slash command, and key
reference/configuration.md<br>Every setting, and what it defaults to
docs/Product.md<br>The map to every design document
docs/decisions.md<br>Every decision on one page
CONTEXT.md<br>The glossary. One concept, one name
Contributing
make verify
That is exactly what CI checks on every change. make help lists every target.<br>Read AGENTS.md before you open a pull request.
MIT licensed. See LICENSE.
About<br>An autonomous, multi-tenant, AI-native software factory.<br>Resources<br>Readme<br>MIT license<br>Activity<br>Custom properties<br>Stars<br>4 stars<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.