README file from
GithubLingXi1949
English / 简体中文
Stop moving context by hand: send notes to your agent in one click.
Features
- Reach another computer without network setup: pair a Windows or Linux device with a connection code—no account, public IP, or inbound port required. Connections prefer peer-to-peer and use an encrypted relay only when necessary.
- Keep every task in its own terminal: work across several devices and independent terminal sessions without one disconnected or closed session interrupting the others.
- Stop hunting for paths: double-click a directory to make the terminal enter it; double-click a file to insert its path at the AI TUI cursor. Dragging works too.
- Put notes where the work is: drag a note into the terminal or its directory tree and keep its Vault-relative structure. Per-file receipts and modification markers show what actually arrived.
- Give the agent complete context: send the current note, selection, or path in one action, with optional linked notes and recursively collected backlinks.
- Avoid repeating terminal routines: review session input, save useful steps as a device-specific shortcut group, and replay them later. LingXi1949 pauses instead of guessing when completion is uncertain.
- Use your preferred AI CLI: launch Claude Code, Codex, or OpenCode from one place and see availability before starting.
- Keep private work private: offline mode suppresses optional network checks, and LingXi1949 includes no client-side telemetry, usage analytics, or error-reporting beacon.
Installation
LingXi1949 supports Obsidian Desktop only.
Install the plugin
The recommended route is Obsidian Community Plugins:
- Open Settings → Community plugins and turn off Restricted mode if it is enabled.
- Select Browse and search for
LingXi. - Install and enable LingXi1949.
For earlier access to the latest tagged build, install BRAT and add Cyber-bike1949/LingXi1949.
Use a local terminal
Run LingXi1949: Open terminal from the Obsidian command palette and choose This device. Install and sign in to AI CLI tools such as Claude Code, Codex, or OpenCode separately on this computer.
Connect a remote Linux Agent
On Linux x64, run the installer as the ordinary user who will own the remote shell:
curl -fsSL https://raw.githubusercontent.com/Cyber-bike1949/LingXi1949/main/agent/packaging/install-linux.sh | bash
The script downloads and verifies the Agent, starts its user service, and displays a connection code. Paste the code into the plugin's Add device entry. If no code appears, run ~/.local/bin/lingxi1949 status.
Connect a remote Windows Agent
Download the Windows x64 Agent and its SHA-256 checksum, or run this block in PowerShell:
$baseUrl = 'https://github.com/Cyber-bike1949/LingXi1949/releases/latest/download'
Invoke-WebRequest "$baseUrl/lingxi1949-win32-x64.exe" -OutFile 'lingxi1949.exe'
Invoke-WebRequest "$baseUrl/lingxi1949-win32-x64.exe.sha256" -OutFile 'lingxi1949.exe.sha256'
$expectedHash = (Get-Content 'lingxi1949.exe.sha256').Split()[0]
$actualHash = (Get-FileHash '.\lingxi1949.exe' -Algorithm SHA256).Hash
if ($actualHash -ne $expectedHash) { throw 'SHA-256 verification failed' }
.\lingxi1949.exe run
Keep the Agent running, then add the device with its connection code. Before using real content, verify hostname and pwd (Get-Location in PowerShell) and transfer a sample note that contains no personal information.
Be water, my friend! — Bruce Lee(活得像水一样吧,朋友。)