Zyn Agent

Local AI agent for terminal, TUI, and web.

Official repository

---

What is Zyn

Zyn is a local AI agent designed for terminal and web usage. It supports persistent sessions, system tools, multiple AI providers, session exports, and configurable models.

---

Requirements

• Node.js 18+
• npm
• Internet connection for remote providers

---

Installation

Global install

npm install -g zyn-ai
zyn

Local development

git clone https://github.com/SoyMaycol/Zyn.git
cd Zyn
npm install
npm start

---

Usage

zyn
zyn "Explain this project"
zyn --new
zyn --resume ID

---

Web mode

Inside Zyn:

/web
/web 0.0.0.0:3000

Or directly:

npm run web

---

Language

Supported languages:

• en
• es

Commands:

/lang
/lang en
/lang es

---

Main Commands

Sessions

Command	Description
/help	Show available commands
/status	Show current status
/history	Show recent actions
/memory	Show memory summary
/sessions	List saved sessions
/new	Create a new session
/resume <ID>	Resume a session
/title <text>	Rename session

Configuration

Command	Description
/model	Show or change model
/models	List models
/providers	List providers
/lang <en|es>	Change language
/config show	Show config
/auto on|off	Toggle auto approval
/cwd <path>	Change working directory

Tools

Command	Description
/tools	List tools
/skills	List skills
/gmail connect	Connect Gmail with Google OAuth + PKCE
/gmail status	Show Gmail connection status
/gmail disconnect	Remove saved Gmail tokens
/cwd	Show working directory

Web & Export

Command	Description
/web	Start web interface
/transcript	Show transcript
/export	Export session

Control

Command	Description
/stop	Stop current task
/reset	Reset session
/exit	Exit Zyn

In the TUI, press ESC twice to stop the current task.

---

Models

Custom models can be added using data/models.json.

Example:

{
  "models": {
    "my-gemini-flash": {
      "label": "Gemini Flash",
      "provider": "gemini",
      "geminiModel": "gemini-flash"
    }
  }
}