Oxideterm

v1.0.0Developer Toolsstable

Local-first SSH workspace for local shells and remote machines — SSH, SFTP, trzsz, port forwarding, lightweight remote editing, file management, and BYOK AI in one native binary. Built with Tauri 2 and pure Rust SSH. Zero Electron, zero OpenSSL, zero

agentai-terminalbring-your-own-keydevtoolsfilemanager
Share:
712
Stars
0
Downloads
0
Weekly
0/5

What is Oxideterm?

Oxideterm is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to local-first ssh workspace for local shells and remote machines — ssh, sftp, trzsz, port forwarding, lightweight remote editing, file management, and byok ai in one native binary. built with tauri 2 an...

Local-first SSH workspace for local shells and remote machines — SSH, SFTP, trzsz, port forwarding, lightweight remote editing, file management, and BYOK AI in one native binary. Built with Tauri 2 and pure Rust SSH. Zero Electron, zero OpenSSL, zero

This server falls under the Developer Tools and File Systems categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Local-first SSH workspace for local shells and remote machin

Use Cases

Local-first SSH workspace for local shells and remote machines — SSH, SFTP, trzs
LicenseGPL-3.0
Languagerust
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx oxideterm

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Oxideterm

Oxideterm is a local-first SSH workspace application built with Tauri 2 and pure Rust SSH (no OpenSSL, no Electron) that combines SSH terminal multiplexing, dual-pane SFTP file management, in-terminal file transfer (trzsz), port forwarding, a CodeMirror-based remote editor, and an AI assistant (OxideSens) powered by your own API keys — all in a single native binary. Its MCP server integration lets AI agents diagnose remote output, run approved commands, and inspect files across SSH sessions without requiring cloud platform sign-up. DevOps engineers and remote developers use it to manage fleets of servers with AI assistance while keeping all credentials and data local.

Prerequisites

  • Rust 1.85+ and Cargo installed (for building from source)
  • Node.js 18+ and pnpm installed (for frontend build)
  • Platform build tools: Xcode Command Line Tools on macOS, build-essential on Linux, or Visual Studio C++ Build Tools on Windows
  • An MCP client such as Claude Desktop or Claude Code
  • Optional: OpenAI, Ollama, or DeepSeek API key for the OxideSens AI assistant feature
1

Clone the repository

Clone the Oxideterm repository to your local machine.

git clone https://github.com/AnalyseDeCircuit/oxideterm.git
cd oxideterm
2

Install frontend dependencies

Install Node.js dependencies using pnpm.

pnpm install
3

Build the CLI companion

Build the oxt CLI tool which provides JSON-RPC 2.0 automation over Unix socket.

pnpm cli:build
4

Run in development mode

Launch the full Tauri application with hot reload for development and testing.

pnpm run tauri dev
5

Build a production binary

Compile the final native binary for your platform.

pnpm run tauri build
6

Configure Claude Desktop for MCP integration

Register Oxideterm as an MCP server in Claude Desktop. The server exposes tools for SSH session management and AI-assisted remote operations.

{
  "mcpServers": {
    "oxideterm": {
      "command": "npx",
      "args": ["oxideterm"]
    }
  }
}
7

Configure SSH connections

Oxideterm auto-parses your ~/.ssh/config file on startup. Add your SSH hosts there and they will appear in the connection list. ProxyJump chains are supported automatically.

Oxideterm Examples

Client configuration

Claude Desktop configuration for the Oxideterm MCP server.

{
  "mcpServers": {
    "oxideterm": {
      "command": "npx",
      "args": ["oxideterm"]
    }
  }
}

Prompts to try

Example prompts for SSH management, file transfer, and AI-assisted remote operations through Oxideterm.

- "Connect to my server at prod-web-01 and show me the last 100 lines of /var/log/nginx/error.log"
- "Transfer /tmp/deploy.tar.gz from my local machine to /opt/app/ on staging-server"
- "Set up a local port forward: map localhost:5432 to the remote postgres port on db-server"
- "Diagnose why the application on app-server is returning 502 errors — check logs and running processes"
- "Open the file /etc/nginx/nginx.conf on web-server in the remote editor"

Troubleshooting Oxideterm

Build fails with missing Rust toolchain

Install Rust via rustup: 'curl --proto =https --tlsv1.2 -sSf https://sh.rustup.rs | sh'. Then run 'rustup update stable' to ensure you have Rust 1.85+.

Tauri build fails on Linux with missing WebKit dependency

Install the required system library: 'sudo apt install libwebkit2gtk-4.1-dev' on Debian/Ubuntu. On Fedora: 'sudo dnf install webkit2gtk4.1-devel'.

SSH connection drops and does not reconnect automatically

Oxideterm includes a Grace Period feature that probes the old connection for 30 seconds before replacing it. Brief network interruptions should recover automatically. For persistent drops, check that the remote sshd MaxSessions and ClientAliveInterval settings are not too restrictive.

Frequently Asked Questions about Oxideterm

What is Oxideterm?

Oxideterm is a Model Context Protocol (MCP) server that local-first ssh workspace for local shells and remote machines — ssh, sftp, trzsz, port forwarding, lightweight remote editing, file management, and byok ai in one native binary. built with tauri 2 and pure rust ssh. zero electron, zero openssl, zero It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Oxideterm?

Follow the installation instructions on the Oxideterm GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Oxideterm?

Oxideterm works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Oxideterm free to use?

Yes, Oxideterm is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "oxideterm": { "command": "npx", "args": ["-y", "oxideterm"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Oxideterm?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides