tim-agent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by tim-today. Native GUI Terminal Agent & Mobile Vibe Coding Hub for Claude Code, Codex & CLI Agents. Seamless Phone ↔ PC task collaboration over Tailscale & FRP. It has 52 GitHub stars.

Is tim-agent safe to use?

tim-agent's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install tim-agent?

Clone the repository with "git clone https://github.com/tim-today/tim-agent" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is tim-agent written in?

tim-agent is primarily written in Go. It is open-source under tim-today on GitHub, so you can review or fork the full source.

Are there alternatives to tim-agent?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh tim-agent against similar tools.

Tim-Agent 🚀

Name: tim-agent
Author: tim-today

🇺🇸 English

🎯 Core Purpose & Philosophy

Tim-Agent is purpose-built for seamless bidirectional task collaboration between Mobile Phones and PC workstations.
Traditional remote terminal setups are frustrating on mobile touchscreens and break connections when screens lock. Tim-Agent provides a zero-friction mobile companion terminal and multi-project session hub for your desktop workstation.

🌟 Why Tim-Agent?

🛡️ Zero API Token Setup & Zero Leakage Risk: No need to provide, store, or proxy sensitive LLM API keys. Tim-Agent does not handle credentials, eliminating any risk of token leakage.
📂 Multi-Project & Multi-Session Hub: Configure multiple projects in the Control Panel (each with its own Project Name, unique WorkDir, CLI Agent preset, and Auto-Approve mode). Remote connections default to your most recently active session; switching projects in the terminal top bar (📂 Project ▾) keeps previous project sessions running concurrently in the background.
🖥️ Desktop GUI Application & CLI Dual Mode: In addition to command-line startup, Tim-Agent provides native double-click GUI applications for macOS (TimAgent.app), Windows (TimAgent-windows-amd64-gui.exe without console window), and Linux (.desktop GUI bundle). Or run tim-agent -install-app (or click 🖥️ Generate Desktop App in the dashboard) to create a desktop app icon in one click.
💻 Inherits 100% of Native Host Environment: Works directly inside your local project folders. Automatically utilizes your local Git credentials, SSH keys, compiler tools, virtual environments, and shell configs.
🔄 Seamless Cross-Device Relay (Phone ↔ PC): Start a task at your desk, continue on your phone while walking away; approve changes on mobile, and pick up right where you left off when back at your PC.
⚡ Resilient to Network Jitter & Drops: Decoupled from fragile SSH pipes. The host PC daemon continues executing builds, tests, and AI agent reasoning uninterrupted in the background.
🤖 Powered by Official First-Party AI Agents: Directly drives official tools like Anthropic Claude Code CLI, OpenAI Codex CLI, and Google Gemini CLI.
📲 Progressive Web App (PWA) & Magic Mobile Keyboard: Install as a standalone PWA on mobile, featuring a 2-row Vibe Coding toolbar (/resume, /model, magic long-press backspace to clear entire line, 0-9 & Ctrl+ pickers) and Network-First auto-updates.

⚡ Quick Start (GUI App or CLI)

Option A: Mouse Double-Click GUI Application Download the release package for your OS from GitHub Releases (TimAgent-macos-*.app.zip, TimAgent-windows-amd64-gui.exe, or TimAgent-linux-*-gui.tar.gz) and double-click to launch directly into the system tray and Control Panel.

Option B: Run Instantly via Go CLI

# 1. Run with defaults (launches dashboard & system tray)
go run github.com/tim-today/tim-agent@latest

# 2. Specify AI agent, directory, and port
go run github.com/tim-today/tim-agent@latest -agent claude -dir /path/to/project -port 20996

# 3. One-click install native Desktop GUI App (.app / .lnk / .desktop)
go run github.com/tim-today/tim-agent@latest -install-app

⚙️ Command-Line Arguments

Flag	Type	Default	Description
`-agent`	`string`	`""` (Shell)	Default AI Agent preset (`claude`, `codex`, `opcode`, `pi`, `gemini`)
`-port`	`int`	`20996`	Terminal port (auto-increments if busy; admin dashboard on `20997`)
`-dir`	`string`	Current dir	Working directory bound to the initial project session
`-auto-approve`	`bool`	`false`	Auto-approve prompts / bypass sandbox for Claude Code & Codex
`-install-app`	`bool`	`false`	Generate and install native Desktop GUI Application icon for current OS
`-password`	`string`	Auto-gen	Web terminal password protection (cached after first login)
`-shell`	`string`	System `$SHELL`	Custom shell executable (`/bin/zsh`, `/bin/bash`, `powershell.exe`)
`-no-open`	`bool`	`false`	Do not automatically pop up local dashboard in browser on start
`-remote`	`bool`	`false`	Enable remote access to web dashboard (default localhost only, requires password)
`-daemon`	`bool`	`false`	Run with supervisor watchdog for auto-recovery, ensuring 24/7 port uptime
`-version`	`bool`	`false`	Print version information and exit

🌐 Remote Access & Networking

Tim-Agent serves the shared terminal on port 20996. For remote mobile access, we recommend:

Tailscale (Recommended): Zero-config private mesh VPN. No port forwarding needed; scan the dashboard's auto-generated QR code to connect instantly.
FRP / Tunneling: Forward port 20996 through your public VPS for remote cellular access anywhere.
LAN (Wi-Fi): Direct connection within the same local network via the LAN QR code.

🇨🇳 简体中文

🎯 项目初衷与核心价值

Tim-Agent 重点解决「手机与 PC 之间的任务协同与多项目会话管理」问题。
开发者经常需要在手机上监控或远程处理电脑端的多个项目构建、测试任务，或与 AI 命令行 Agent（如 Claude Code CLI、Codex CLI）交互协同。传统远程终端不仅手机触屏极难操作，且断网重连与多项目切换体验极差。Tim-Agent 让手机成为电脑端多项目终端任务的最佳协同副屏。

🌟 项目核心特点

🛡️ 无需配置 API Token，零泄密风险：无需在网页或配置文件中填入任何大模型 API Key。Tim-Agent 本身不存储、不中转任何密钥凭据，彻底杜绝敏感信息外泄风险。
📂 多项目与多会话并行管理：支持在后台配置界面添加多个独立项目（每个项目独立设置项目名称、工作目录 WorkDir、CLI Agent 代理、是否自动确认，并严格限制同一目录不可属于不同项目）。远程连接默认自动进入最近操作的一个会话，也可在终端顶部栏（📂 项目名 ▾）或控制面板一键切换到其它项目；切换后原项目会话继续在后台保持运行，随时切回无缝接力。
🖥️ 原生桌面 GUI 应用程序（鼠标双击即开）+ 命令行双模式：除命令行直接启动外，原生支持生成 macOS (TimAgent.app)、Windows (TimAgent-windows-amd64-gui.exe 无黑框窗口)、Linux (.desktop 桌面应用) 图形程序，鼠标双击图标直接启动常驻托盘并打开控制面板；二次双击图标会自动唤醒已运行实例的控制面板。同时支持通过 -install-app 参数或控制面板顶部的「🖥️ 生成桌面应用」按钮一键生成桌面应用图标。
💻 完全沿用电脑本机环境与配置：直接工作在电脑本机的项目目录中，自动继承开发者的 Git 凭据、SSH Key、Homebrew/nvm 环境变量、编译器及终端配置。
🔄 手机 ↔ PC 多端无缝接力与双向协同：真正实现“电脑工作做一半，出门手机继续完成；手机审批或输入一半，回工位电脑无缝接力”。
⚡ 无视网络抖动，电脑多项目 Agent 独立常驻后台：彻底告别传统 SSH 在地铁、电梯或网络切换时 Broken Pipe 导致任务中断的痛点。
🤖 采用顶级官方原生 Agent：原生直接驱动 Anthropic 官方 Claude Code CLI、OpenAI 官方 Codex CLI、Google Gemini CLI 等原生工具。
📲 PWA 本地应用与手机端定制虚拟键盘：支持一键安装为手机桌面独立 App（PWA），适配刘海屏安全区域确保顶栏始终可见；配备双排 Vibe Coding 快捷胶囊（含 /resume 恢复会话、/model、退格键长按连续加速删除及长按一键清空整行魔法功能）。

⚡ 快速开始（GUI 鼠标点开 / 命令行启动）

方式一：鼠标双击 GUI 应用程序启动

从 GitHub Releases 下载对应系统的 GUI 应用包（macOS 为 TimAgent-macos-*.app.zip，Windows 为 TimAgent-windows-amd64-gui.exe，Linux 为 TimAgent-linux-*-gui.tar.gz），或在本机编译 make app 生成 bin/TimAgent.app，直接用鼠标双击即可无黑框启动。
也可以在已运行的控制面板右上角点击 「🖥️ 生成桌面应用」 按钮，自动将程序安装到系统应用程序列表与桌面。

方式二：通过 Go 命令行直接运行

# 1. 默认直接运行 (自动打开控制面板并常驻系统托盘)
go run github.com/tim-today/tim-agent@latest

# 2. 传入参数启动 (指定 Agent、工作目录、端口)
go run github.com/tim-today/tim-agent@latest -agent claude -dir /path/to/project -port 20996

# 3. 一键在当前电脑生成并安装桌面 GUI 应用程序 (.app / .lnk / .desktop)
go run github.com/tim-today/tim-agent@latest -install-app

⚙️ 运行参数列表

参数选项	类型	默认值	说明
`-agent`	`string`	`""` (系统Shell)	默认启动的 Agent 智能体 (`claude`, `codex`, `opcode`, `pi`, `gemini`)
`-port`	`int`	`20996`	终端服务监听端口（冲突自动递增；本地控制面板自动分配 `20997`）
`-dir`	`string`	当前执行目录	绑定工作目录 (`pwd`)
`-auto-approve`	`bool`	`false`	开启沙箱免确认/自动批准（自动注入 `--dangerously-skip-permissions` 等参数）
`-install-app`	`bool`	`false`	一键生成并安装本机桌面 GUI 应用程序图标（支持鼠标直接点开）
`-password`	`string`	自动生成强密码	终端访问密码保护（浏览器输入一次自动记住持久凭证）
`-shell`	`string`	环境变量 `$SHELL`	指定 Shell 解释器路径 (如 `/bin/zsh`, `powershell.exe`)
`-no-open`	`bool`	`false`	启动后不自动在本地浏览器弹出控制面板
`-remote`	`bool`	`false`	允许外部IP远程访问控制面板（默认仅限本机 127.0.0.1/localhost 访问，开启需密码鉴权）
`-daemon`	`bool`	`false`	开启独立 Supervisor 守护监控，异常崩溃秒级自愈重启，保证端口常驻
`-version`	`bool`	`false`	查看版本信息并退出

🌐 外网与远程网络推荐

Tim-Agent 默认在电脑端监听 20996 端口。需要不在电脑旁随时随地用手机访问时，推荐使用以下方案映射外网：

Tailscale（强烈推荐）：私有网状 VPN，无需公网 IP 和复杂配置，手机与电脑加入同一账号后，控制面板自动生成 Tailscale 专用二维码，手机扫码秒级直连。
FRP / 内网穿透：通过云服务器将电脑的 20996 端口映射出去，手机在任意蜂窝移动网络下皆可随时随地访问。
局域网 Wi-Fi：同局域网下直接扫描控制面板的 LAN 二维码连接。

🇭🇰 繁體中文

🎯 專案初衷與核心價值

Tim-Agent 專注於解決「手機與 PC 之間的任務協同與多專案會話管理」問題。
告別傳統遠端終端連線方案繁瑣脆弱的體驗，讓手機成為電腦端多專案開發任務最靈活的隨身副屏。

🌟 專案核心特點

🛡️ 無需配置 API Token，零洩密風險：不需在網頁或設

tim-agent

Compare with similar skills

Frequently Asked Questions

What is tim-agent?