Skip to main content

README.md

# EAI

**EAI Agent Framework** — triple-notation knowledge graphs, agent-browser workflows, and PTY-resilient tooling.

## Installation

```elixir
def deps do
  [
    {:eai, "~> 0.1.0"}
  ]
end
```

## Core Concepts

### Triple Notation

Everything worth remembering is a triple:

```
<<subject, predicate, object>>
```

Append one line to `TRANSITION.md` (global) or `PROJECT_TRANSITION.md` (local). No classification, no folders, no schema — just edges in a graph.

Query with `dispatch.py`:

```bash
python dispatch.py TRANSITION.md matrix       # visualize
python dispatch.py TRANSITION.md path A B     # shortest logical path
python dispatch.py TRANSITION.md query A B 5  # next valid hops
python dispatch.py TRANSITION.md deps X       # what X depends on
```

### agent-browser

```bash
agent-browser install
agent-browser open https://example.com
agent-browser snapshot -i          # get @refs
agent-browser click @e11           # interact
agent-browser eval "js code"       # raw JS
```

> **ARM64 note:** always pass `--executable-path /usr/bin/chromium`

### PTY Resilience

Interactive TUIs kill sessions. The universal cure:

```elixir
list_sessions()    # find stuck agent_id
reset_session(id)  # nuke and restart fresh
```

## License

MIT