Neywa

AI-Powered Personal OS via Discord + Claude Code

Website • Installation • Features • Commands • License

---

What is Neywa?

Neywa is an AI assistant that lives in your Discord. It connects Claude Code to Discord, giving you access to a powerful AI that can:

• Read and write files on your computer
• Execute terminal commands
• Search the web
• Help with coding, research, and everyday tasks

All through Discord DMs or channels.

Features

• Real-time Streaming - See Claude's responses as they're generated
• Multi-user Support - Claude knows who's talking in group channels
• Message Queue - Messages sent while processing are queued automatically
• Instant Stop - Cancel processing with !stop
• Session Persistence - Continue conversations across restarts (saved to disk)
• Menu Bar App - macOS tray icon shows status and version
• Auto Update - Update via Discord with !update command
• Auto Start - Launch on login with neywa service install
• Sleep Prevention - System stays awake for remote access (display can turn off)
• Z Mode - Toggle between Claude (Anthropic API) and Claude-Z (z.ai API)
• Human Mode - Mute Neywa per channel for human-only conversations
• Restart - Restart Neywa via Discord to fix MCP/connection issues

Installation

Quick Install (macOS)

curl -fsSL https://neywa.ai/install.sh | bash

Manual Build

git clone https://github.com/GodofKim/neywa-os.git
cd neywa-os
cargo build --release

Setup

1. Install Claude Code CLI first: docs.anthropic.com/en/docs/claude-code

2. Create a Discord Bot:

   • Go to Discord Developer Portal
   • Create new application → Bot → Copy token
   • Enable: Message Content Intent, Server Members Intent, Presence Intent
   • Invite bot to your server with Manage Channels, Send Messages, Read Message History, Attach Files permissions

3. Get your Discord Server (Guild) ID:

   • Enable Developer Mode: Discord Settings > Advanced > Developer Mode
   • Right-click your server icon > Copy Server ID

4. Configure Neywa:

   neywa install  # Enter your bot token and server ID

5. Start the service:

   neywa service install

6. Grant Full Disk Access (important!):

   • System Settings > Privacy & Security > Full Disk Access
   • Add: Neywa.app (from /Applications, auto-created by step 5)
   • Without this, macOS will show permission popups constantly

Commands

Discord Commands

All commands work as both Discord slash commands (/cmd) and text commands (!cmd).

Command	Description
/help	Show available commands
/status	Check session status and queue
/new	Start a new conversation
/stop	Stop current processing and clear queue
/queue	Show queued messages
/compact	Compact session context window
/update	Update Neywa to the latest version
/longtext	How to send long text (over 2000 chars)
/slash <cmd>	Run a Claude Code slash command (e.g., /slash cost)
!z	Toggle Z mode (claude-z / claude) — text only
!human	Toggle human-only mode (Neywa stops responding) — text only
!restart	Restart Neywa (fixes MCP/connection issues) — text only

CLI Commands

Command	Description
neywa install	Configure Discord bot token and server ID
neywa discord channels	List all channels in the server
neywa discord send <channel> <msg>	Send a message to a channel (by name or ID)
neywa discord guild	Show server info
neywa discord create <name> [-t type] [-c category]	Create a channel
neywa discord delete <channel>	Delete a channel (by name or ID)
neywa discord move <channel> <category>	Move a channel to a different category
neywa service install	Enable auto-start on login
neywa service uninstall	Disable auto-start
neywa service status	Check service status

Remote Access

Neywa is perfect for remote access to your computer:

1. Install as service: neywa service install
2. Leave your Mac open (lid open, can lock screen)
3. Access from anywhere via Discord

The service mode automatically prevents system sleep while allowing the display to turn off. Your Mac stays awake and responsive to Discord messages.

Note: Closing the MacBook lid will still trigger sleep. Keep the lid open for remote access.

How It Works

Discord Message → Neywa Daemon → Claude Code CLI → Response → Discord

Neywa acts as a bridge between Discord and Claude Code. When you send a message:

1. Neywa receives it via Discord API
2. Forwards to Claude Code CLI with your context
3. Streams the response back to Discord in real-time
4. Shows tool usage (Read, Write, Bash, Task, Skill, etc.) as status updates

Project Structure

neywa-os/
├── src/
│   ├── main.rs       # CLI entry point
│   ├── discord.rs    # Discord bot handler
│   ├── claude.rs     # Claude Code CLI wrapper
│   ├── discord_api.rs # Discord REST API (channels, send, guild)
│   ├── service.rs    # LaunchAgent management
│   └── tray.rs       # macOS menu bar icon
├── dist/pages/       # Website & binaries
└── Cargo.toml

⚠️ Security Warning

Neywa runs Claude Code with the --dangerously-skip-permissions flag, meaning all actions are executed without approval prompts:

• File read/write/delete
• Terminal command execution
• Web searches

Use with caution. To prevent unwanted actions, create a ~/CLAUDE.md file with restrictions:

# Claude Code Rules

- Never delete files without explicit confirmation
- Never run destructive commands (rm -rf, etc.)
- Never modify files outside the current project

Requirements

• macOS (arm64 or x86_64)
• Claude Code CLI
• Discord Bot Token

Configuration

Config file: ~/.config/neywa/config.json

{
  "discord_bot_token": "your-bot-token",
  "discord_guild_id": 123456789012345678,
  "allowed_user_ids": []
}

Sessions file: ~/.config/neywa/sessions.json (auto-generated)

Development

# Build for current architecture
cargo build --release

# Build for specific target
cargo build --release --target aarch64-apple-darwin
cargo build --release --target x86_64-apple-darwin

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.

---

Built by ALIENZ