whatisgithub

What is xuya-terminal?

xuya-dev/xuya-terminal — explained in plain English

Analysis updated 2026-05-18

27TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

In one sentence

A Windows desktop terminal built for launching and managing AI coding agent sessions like Claude Code and Codex.

Mindmap

mindmap
  root((XuYa Terminal))
    What it does
      AI agent terminal
      One click launch
      Multi tab sessions
    Tech stack
      TypeScript
      Tauri
      Rust
      React
    Use cases
      Claude Code sessions
      Codex sessions
      Provider switching
    Audience
      Developers
      AI coding users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Launch Claude Code, Codex, or OpenCode sessions with one click from a dedicated terminal.

USE CASE 2

Switch between different Chinese AI provider API keys without restarting the whole app.

USE CASE 3

Track remaining API credit and balance for your AI provider in real time.

USE CASE 4

Drag and drop files or paste clipboard images directly into an AI agent session.

What is it built with?

TypeScriptTauriRustReactSQLite

How does it compare?

xuya-dev/xuya-terminal5bv57zcm44-max/noxus-ai-open-whatsappadrianhajdin/react-native-lingua
Stars272727
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/54/53/5
Audiencevibe coderdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Windows only, needs Claude Code, Codex, or OpenCode installed separately plus an API key for your chosen provider.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

XuYa Terminal is a desktop terminal application for Windows, designed specifically for developers who work with AI coding tools like Claude Code, Codex, and OpenCode. The README is written in Chinese. It is built using Tauri, a framework that combines a Rust backend with a React frontend to produce native desktop apps, and targets Windows as its primary platform. The main idea is to give AI agent workflows a dedicated terminal environment rather than using a general-purpose terminal. The app includes one-click launch buttons for Claude Code, Codex, and OpenCode sessions, and handles a Windows-specific annoyance where starting these agents normally requires an extra manual keypress. Sessions open in multi-tab and split-pane layouts. You can drag files into the terminal and the path is inserted automatically, and clipboard images can be pasted directly into AI agent sessions. A configuration panel inside the app manages the settings files that Claude Code and Codex read on startup. You can switch between the official API endpoint and several built-in Chinese AI provider alternatives, such as Zhipu GLM, MiniMax, Kimi, DeepSeek, and Xiaomi Mimo, or enter a custom endpoint and API key. Switching providers restarts just the current agent tab rather than the whole application. The status bar at the bottom shows remaining API credit, used credit, and balance for the active provider, refreshing every minute automatically. Custom provider configurations are saved to a local SQLite database. The theme system is designed with Chinese-language interfaces in mind and includes named dark and light themes with tuned color contrast for terminal ANSI output. The app distributes updates automatically through GitHub Releases using Tauri's built-in updater. Local configuration files, including API keys stored in the SQLite database, are noted as sensitive and should not be shared or committed to public repositories. The project is MIT licensed and in active development, currently at version 0.1.8.

Copy-paste prompts

Prompt 1
How do I install XuYa Terminal and connect it to Claude Code on Windows?
Prompt 2
Show me how to switch XuYa Terminal from the official API to Zhipu GLM.
Prompt 3
Explain how XuYa Terminal's multi-tab and split-pane layout works for AI sessions.
Prompt 4
What does XuYa Terminal's status bar show about my API credit?
Prompt 5
How do I configure a custom AI provider endpoint in XuYa Terminal?

Frequently asked questions

What is xuya-terminal?

A Windows desktop terminal built for launching and managing AI coding agent sessions like Claude Code and Codex.

What language is xuya-terminal written in?

Mainly TypeScript. The stack also includes TypeScript, Tauri, Rust.

What license does xuya-terminal use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is xuya-terminal to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is xuya-terminal for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.