aidotnet-moyucode

MoYuCode（摸鱼Coding）

Introduction

MoYuCode（摸鱼Coding） is an open-source tool designed to help users conveniently operate Codex and Claude Code through a web interface. It supports local deployment and can be accessed externally through intranet mapping, making it convenient for users to use remotely via mobile devices and other platforms. Part of the design experience is inspired by ZCode.

Features

• Web Interface: Modern and responsive web UI built with React + TypeScript + Tailwind CSS
• AI Integration: Seamless integration with OpenAI Codex and Claude Code
• Session Management: Visualize and manage AI coding sessions with detailed history
• Project Workspace: File explorer and code editor integration for seamless development workflow
• Token Usage Tracking: Monitor and visualize token consumption across sessions
• Real-time Updates: Server-Sent Events (SSE) for live AI response streaming
• Cross-platform: Support for Windows, Linux, and macOS
• System Tray: Windows desktop application with tray icon support

Screenshots

System Tray

After launching MoYuCode.Win.exe, a system tray icon appears with the background service running automatically.

Project Selection

Automatically scans and loads local projects that have used Codex, allowing you to select and enter a workspace.

Session Management

• Start new conversations or select from session history
• Load previous sessions to restore full context
• View session details including token usage and timeline

File Browser

Integrated file browser to view and edit code files directly while interacting with AI.

Download & Installation

Windows Desktop Application

1. Visit the GitHub Releases page
2. Download the latest Windows archive (MoYuCode-*-win-x64.zip)
3. Extract and run MoYuCode.Win.exe
4. The program will display an icon in the system tray
5. Open your browser and visit http://localhost:9110/

Linux

1. Download the latest Linux package (MoYuCode-*-linux-x64.tar.gz) from Releases
2. Extract the archive:

   tar -xzf MoYuCode-*-linux-x64.tar.gz
   cd MoYuCode-*-linux-x64
   

3. Run directly:

   ./run.sh
   

4. Or install as a systemd service:

   sudo ./install-service.sh
   

macOS

1. Download the latest macOS package (MoYuCode-*-osx-x64.tar.gz) from Releases
2. Extract the archive:

   tar -xzf MoYuCode-*-osx-x64.tar.gz
   cd MoYuCode-*-osx-x64
   

3. Run directly:

   ./run.sh
   

4. Or install as a launch daemon:

   sudo ./install-service.sh
   

Prerequisites

• .NET 10.0 Runtime (for standalone executables, it's self-contained)
• Codex CLI (required for Codex integration):

  npm install -g @openai/codex
  

Usage

Accessing MoYuCode（摸鱼Coding）

After starting the application, open your browser and navigate to:

• HTTP: http://localhost:9110/
• HTTPS: https://localhost:9111/ (if configured)

Project Workflow

1. Select Project: MoYuCode（摸鱼Coding） automatically scans for projects with Codex usage history
2. Enter Workspace: Click on a project to enter its workspace
3. Start Conversation: Begin a new chat or load a previous session
4. View Code: Use the integrated file browser to view and edit files
5. Monitor Usage: Track token usage and session statistics

Session Management

• Click the session list button in the top-right corner
• Select a historical session
• Click "Load Session" to restore the complete context
• View session details including token usage, timeline, and metadata

Development

Backend (C# / ASP.NET Core)

# Build
dotnet build src/MoYuCode/MoYuCode.csproj

# Run (HTTP)
dotnet run --project src/MoYuCode/MoYuCode.csproj --launch-profile http

# Run (HTTPS)
dotnet run --project src/MoYuCode/MoYuCode.csproj --launch-profile https

Frontend (React / Vite)

cd web

# Install dependencies
npm ci

# Development server
npm run dev

# Build for production
npm run build

# Lint code
npm run lint

Build Full Application

The CI pipeline automatically builds both frontend and backend:

# Install frontend dependencies
npm ci

# Build frontend
npm run build