Zyn Agent

[!CAUTION] Using the web version of the agent is not recommended as it contains bugs. I am doing my best to fix most of the web bugs.

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"
    }
  }
}