dsh-adb-logcat
Android Studio-style ADB logcat viewer for the DeepSeek Harness (DSH) Web GUI.
Connects to ADB devices and shows a live, filterable, color-coded logcat panel — floating over the app or docked under the chat composer, like Android Studio's bottom tool window. Built as a proper installable web plugin (host + browser halves).
Features
- Device list —
adb devices -l, auto-refreshed, with serial / state / model.
- Live streaming —
adb -s <serial> logcat -v threadtime -T 300, parsed into rows.
- Level filtering — show all by default; select V/D/I/W/E/F to show only those levels.
- Text / tag filtering — keyword or regex, with a per-level color legend.
- Level colors — V gray / D blue / I green / W amber / E red / F bright red (theme-aware).
- Layouts — floating (bottom-right capsule) or docked under the chat input box.
- Resizable — drag the panel's top edge to grow/shrink the log area.
- Options — wrap (auto word-wrap), full-width, auto-scroll.
- Auto-start — capture begins when the panel opens (device present).
Requirements
adb on the host PATH (from Android platform-tools).- A device with USB debugging enabled (or an authorized emulator).
Install
dsh plugin --profile web add dsh-adb-logcat
Then restart dsh web.
From a local checkout (development)
dsh plugin --profile web add link:/path/to/dsh-adb-logcat
Usage
- Open the "ADB Logcat" capsule in the bottom-right corner.
- Pick a device (auto-selected when one is present) — capture starts automatically.
- Use the level chips, text / tag filters, and the wrap / full-width / auto-scroll toggles.
- "Dock" moves the panel below the chat input box; "Float" returns it to the overlay.
Security
- The host half mounts a loopback-only HTTP gateway (
/api/logcat/*); remote browsers get 403.
- All device access goes through the host's
subprocess service (no shell string interpolation).
License
MIT
