Skip to content
Back to search

tactus

The first browser AI Agent extension to support Agent Skills, enabling AI to perform complex tasks through an expandable skill system. ๐ŸŒŸ Star if you like it! | ้ฆ–ไธชๆ”ฏๆŒ Agent Skills ็š„ๆต่งˆๅ™จ AI Agent ๆ‰ฉๅฑ•๏ผŒ่ฎฉ AI ้€š่ฟ‡ๅฏๆ‰ฉๅฑ•ๆŠ€่ƒฝ็ณป็ปŸๆ‰ง่กŒๅคๆ‚ไปปๅŠก ๐ŸŒŸ ๅฆ‚ๆžœๅ–œๆฌข่ฏท็‚นไธช Star๏ผ

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/castor6--tactus/badge.svg)](/listings/castor6--tactus)

HTML

<a href="/listings/castor6--tactus"><img src="/api/listings/castor6--tactus/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Download

| Browser | Download | | ------- | -------- | | Chrome | [Chrome Web Store][chrome-store-link] | | Firefox | [Firefox Add-ons][firefox-store-link] |

Or download from [GitHub Releases](https://github.com/Castor6/tactus/releases) for manual installation.

Install

- Chrome / Edge (recommended) - Extract `tactus.zip` to a permanent directory - Open `chrome://extensions/` in Chrome - Enable `Developer mode` (top right) - Click `Load unpacked` (top left) - Select the extracted `tactus` folder - Firefox (temporary debug install) - Run `npm run build:firefox` - Open `about:debugging#/runtime/this-firefox` - Click `Load Temporary Add-on` - Select `.output/firefox-mv2/manifest.json`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 293 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. English | [็ฎ€ไฝ“ไธญๆ–‡](README_ch.md)
  2. # ![icon](public/icon/32.png) Tactus
  3. **The First Browser AI Agent Extension with Agent Skills Support**
  4. [![Chrome Version][chrome-version-shield]][chrome-store-link]
  5. [![Chrome Users][chrome-users-shield]][chrome-store-link]
  6. [![Firefox Version][firefox-version-shield]][firefox-store-link]
  7. [![Firefox Users][firefox-users-shield]][firefox-store-link]
  8. Tactus is an innovative browser extension that brings the [Agent Skills](https://agentskills.io/specification) specification to the browser environment, enabling AI Agent to perform complex tasks through an extensible skill system.
  9. Triggering skills can achieve prompt injection for specific scenarios, and common workflows can be encapsulated in scripts for execution, replacing repetitive automated operations of AI Agents. This approach is both fast and token-efficient.
  10. <!-- Demo GIF -->
  11. ![Tactus Demo](resources/trust-skill.png)
  12. ![Tactus Demo](resources/show-result.png)
  13. ## โœจ Core Features
  14. ### ๐Ÿงฉ Agent Skills System
  15. Tactus is the first product to implement the Agent Skills specification in a browser extension:
  16. - **Skill Import** - Import spec-compliant Skill folders containing instructions, scripts, and resource files
  17. - **Script Execution** - Safely execute JavaScript scripts within pages
  18. - **Trust Mechanism** - First-time script execution requires user confirmation, with option to permanently trust
  19. <!-- Skills Import Demo -->
  20. ![Skills Import Demo](resources/add-skill.png)
  21. ### ๐Ÿค– Intelligent Conversation
  22. - **Multi-Provider Support** - Native support for Anthropic (Claude), Gemini (Google), and any OpenAI-compatible API provider
  23. - **Multi-Model Switching** - Configure multiple providers and switch models anytime
  24. - **Streaming Response** - Real-time AI replies with chain-of-thought display
  25. - **ReAct Paradigm** - Built-in complete tool calling loop, AI autonomously decides when to use tools
  26. - **Stop Generation** - Interrupt ongoing AI generation or tool calls at any time
  27. - **Tab Lock** - Automatically locks the tab during AI responses with a glowing animation to prevent accidental navigation
  28. - **Preset Quick Actions** - Quick action buttons for common prompts in the chat panel
  29. ### ๐Ÿ–ผ๏ธ Image Vision Support
  30. - **Vision Model Config** - Configure vision capability independently per model
  31. - **Paste Images** - Paste images directly in the chat input to send to AI
  32. - **Multimodal Chat** - Support image-text mixed queries, letting AI understand screenshots, charts, and other visual content
  33. <!-- Vision Demo -->
  34. ![Vision Demo](resources/identify-image.png)
  35. ### ๐Ÿ“„ Page Understanding
  36. - **Smart Extraction** - Uses Readability + Turndown to extract core page content and convert to Markdown
  37. - **Selection Quote** - Select text on page or in sidebar and quote it with one click
  38. - **Context Awareness** - AI determines whether to call page extraction tool; skips if skill script provides content
  39. - **Raw Extraction Mode** - Configure specific websites to skip Readability algorithm and extract raw page content directly
  40. <!-- Page Interaction Demo -->
  41. ![Page Interaction Demo](resources/page-interaction.png)
  42. ### ๐Ÿ”Œ HTTP MCP Support
  43. Connect to external tool servers via [Model Context Protocol](https://modelcontextprotocol.io/), extending AI capabilities:
  44. - **MCP Server Connection** - Add and manage multiple HTTP MCP Servers
  45. - **Dynamic Tool Discovery** - Automatically fetch available tools from MCP Server and integrate into conversations
  46. - **Multiple Auth Methods**:
  47. - No authentication (public services)
  48. - Bearer Token authentication
  49. - OAuth 2.1 authentication (with auto-refresh)
  50. <!-- MCP Config Demo -->
  51. https://github.com/user-attachments/assets/c7737e7e-dd2e-4888-a030-db40b9731f1d
  52. ### ๐ŸŽจ Themes & Personalization
  53. - **Theme Switching** - Support light, dark, and system-follow theme modes
  54. - **Floating Ball Toggle** - Freely enable/disable the floating ball on the right side of the page
  55. - **Selection Quote Toggle** - Freely enable/disable the selection quote feature
  56. - **Internationalization** - Support Chinese/English interface switching
  57. ### ๐Ÿ’พ Local Storage
  58. - **Session Management** - Conversation history stored locally with pagination support
  59. - **Message Editing** - Edit sent user messages and regenerate replies
  60. - **Message Copy** - One-click copy for AI replies
  61. - **IndexedDB** - Skills and files stored in local database
  62. - **Privacy First** - All data saved locally, nothing uploaded to any server
  63. ### โš™๏ธ Advanced Configuration
  64. - **Web Content Char Limit** - Configure maximum characters for extracted page content to control token usage
  65. - **Tool Call Limit** - Configure maximum tool calls per conversation to prevent infinite loops
  66. - **Smart Base URL Handling** - Auto-complete `/v1/chat/completions` path to simplify API configuration
  67. - **API Endpoint Preview** - Preview the full API endpoint URL below the Base URL input
  68. - **Auto-Save Config** - Model provider and MCP server configurations are automatically saved with debounce
  69. - **Open Links in New Tabs** - Links in AI responses open in new tabs to preserve your conversation
  70. ## ๐Ÿš€ Quick Start
  71. ### Download
  72. | Browser | Download |
  73. | ------- | -------- |
  74. | Chrome | [Chrome Web Store][chrome-store-link] |
  75. | Firefox | [Firefox Add-ons][firefox-store-link] |
  76. Or download from [GitHub Releases](https://github.com/Castor6/tactus/releases) for manual installation.
  77. ### Install
  78. - Chrome / Edge (recommended)
  79. - Extract `tactus.zip` to a permanent directory
  80. - Open `chrome://extensions/` in Chrome
  81. - Enable `Developer mode` (top right)
  82. - Click `Load unpacked` (top left)
  83. - Select the extracted `tactus` folder
  84. - Firefox (temporary debug install)
  85. - Run `npm run build:firefox`
  86. - Open `about:debugging#/runtime/this-firefox`
  87. - Click `Load Temporary Add-on`
  88. - Select `.output/firefox-mv2/manifest.json`
  89. ## ๐Ÿ› ๏ธ Build from Source
  90. 1. Clone the repository
  91. ```bash
  92. git clone https://github.com/Castor6/tactus.git
  93. cd tactus
  94. ```
  95. 2. Install dependencies
  96. ```bash
  97. npm install
  98. ```
  99. 3. Run in development mode
  100. ```bash
  101. npm run dev
  102. npm run dev:firefox
  103. ```
  104. 4. Build for production
  105. ```bash
  106. npm run build
  107. npm run build:firefox
  108. ```
  109. 5. Please use the Professional style within the `.claude\skills\design-style` skills to design with a unified extended UI style.
  110. ## ๐Ÿ“– User Guide
  111. ### Configure AI Provider
  112. 1. Click the extension icon to open the sidebar
  113. 2. Click the settings button to enter configuration page
  114. 3. Add API provider (fill in name, API URL, key)
  115. 4. Fetch model list and select a model
  116. 5. Enable vision config in model settings if vision capability is needed
  117. <!-- Configuration Demo -->
  118. ![Configuration Demo](resources/set-llm.png)
  119. ### Import Skill
  120. 1. Find the Skills management area in settings page
  121. 2. Click "Import Skill" button
  122. 3. Select a folder containing `SKILL.md`
  123. 4. Confirm import and use it in conversations
  124. ### Configure MCP Server
  125. 1. Find the MCP management area in settings page
  126. 2. Click to add an MCP Server
  127. 3. Fill in Server URL and select authentication method
  128. 4. Once connected, tools provided by MCP will be automatically integrated into conversations
  129. ### Skill Folder Structure
  130. ```
  131. my-skill/
  132. โ”œโ”€โ”€ SKILL.md # Required: Skill definition and instructions
  133. โ”œโ”€โ”€ scripts/ # Optional: Executable scripts
  134. โ”‚ โ””โ”€โ”€ fetch-data.js
  135. โ”œโ”€โ”€ references/ # Optional: Reference documents
  136. โ”‚ โ””โ”€โ”€ api-docs.md
  137. โ””โ”€โ”€ assets/ # Optional: Resource files
  138. โ””โ”€โ”€ template.json
  139. ```
  140. ### SKILL.md Format
  141. ```markdown
  142. ---
  143. name: my-skill
  144. description: This is an example skill
  145. ---
  146. # Skill Instructions
  147. When user needs to perform a task, follow these steps:
  148. 1. First analyze user requirements
  149. 2. Call scripts/fetch-data.js to fetch data
  150. 3. Organize and return results
  151. ```
  152. ## ๐Ÿ› ๏ธ Tech Stack
  153. - **Framework**: [WXT](https://wxt.dev/) - Modern browser extension development framework
  154. - **Frontend**: Vue 3 + TypeScript
  155. - **AI Integration**: Native Anthropic (Claude) API, Native Gemini (Google) API, OpenAI SDK (compatible with any OpenAI API)
  156. - **MCP Support**: @modelcontextprotocol/sdk - Model Context Protocol client
  157. - **Content Extraction**: @mozilla/readability + turndown
  158. - **Storage**: IndexedDB (idb) + WXT Storage
  159. - **Authentication**: OAuth 2.1 support (for MCP Server auth)
  160. ## ๐Ÿ”ง Built-in Tools
  161. Tactus provides the following built-in tools for AI:
  162. | Tool | Description |
  163. |------|-------------|
  164. | `extract_page_content` | Extract main content from current page |
  165. | `activate_skill` | Activate a specified Skill |
  166. | `execute_skill_script` | Execute script within a Skill |
  167. | `read_skill_file` | Read file content from a Skill |
  168. | **MCP Tools** | Dynamically fetched tools from connected MCP Servers |
  169. ## ๐Ÿ“ Development
  170. ### Project Structure
  171. ```
  172. tactus/
  173. โ”œโ”€โ”€ entrypoints/
  174. โ”‚ โ”œโ”€โ”€ background.ts # Background script
  175. โ”‚ โ”œโ”€โ”€ content.ts # Content script
  176. โ”‚ โ”œโ”€โ”€ sidepanel/ # Sidebar UI
  177. โ”‚ โ””โ”€โ”€ options/ # Settings page
  178. โ”œโ”€โ”€ components/ # Vue components
  179. โ”œโ”€โ”€ utils/
  180. โ”‚ โ”œโ”€โ”€ anthropic.ts # Anthropic (Claude) API integration
  181. โ”‚ โ”œโ”€โ”€ api.ts # API calls & tool execution
  182. โ”‚ โ”œโ”€โ”€ db.ts # IndexedDB operations
  183. โ”‚ โ”œโ”€โ”€ gemini.ts # Gemini (Google) API integration
  184. โ”‚ โ”œโ”€โ”€ storage.ts # Settings & storage management
  185. โ”‚ โ”œโ”€โ”€ i18n.ts # Internationalization
  186. โ”‚ โ”œโ”€โ”€ mcp.ts # MCP Client management
  187. โ”‚ โ”œโ”€โ”€ mcpOAuth.ts # MCP OAuth 2.1 auth
  188. โ”‚ โ”œโ”€โ”€ mcpStorage.ts # MCP config storage
  189. โ”‚ โ”œโ”€โ”€ skills.ts # Skills core logic
  190. โ”‚ โ”œโ”€โ”€ skillsExecutor.ts # Script executor
  191. โ”‚ โ”œโ”€โ”€ skillsImporter.ts # Skills import
  192. โ”‚ โ”œโ”€โ”€ tools.ts # Tool definitions
  193. โ”‚ โ””โ”€โ”€ pageExtractor.ts # Page content extraction
  194. โ””โ”€โ”€ public/ # Static assets
  195. ```
  196. ## ๐Ÿค Contributing
  197. Issues and Pull Requests are welcome!
  198. ## ๐Ÿšง Future Roadmap
  199. We have exciting plans for the future development of Tactus:
  200. - [ ] Introduce CDP automation as a tool for the Agent, allowing manual intervention and takeover.
  201. - [ ] Record operations and generate reusable skills with a single click.
  202. - [ ] Tackle the challenges of long-term stable automation tasks.
  203. ## ๐Ÿ“„ License
  204. Apache-2.0 License
  205. ## โญ Star History
  206. [![Star History Chart](https://api.star-history.com/svg?repos=Castor6/tactus&type=Date)](https://star-history.com/#Castor6/tactus&Date)
  207. ## Friendship Link
  208. Thanks for the support and feedback from the friends at [LINUX DO](https://linux.do/). Let's make tactus better and better together!
  209. ---
  210. **Tactus** - granting AI the sense of touch to navigate the web ๐Ÿš€
  211. <!-- LINK GROUP -->
  212. [chrome-store-link]: https://chromewebstore.google.com/detail/tactus/nmhndbemnmmigjooiafblchoegecmkhh
  213. [chrome-version-shield]: https://img.shields.io/chrome-web-store/v/nmhndbemnmmigjooiafblchoegecmkhh?style=flat-square&label=Chrome&labelColor=black&color=blue
  214. [chrome-users-shield]: https://img.shields.io/chrome-web-store/users/nmhndbemnmmigjooiafblchoegecmkhh?style=flat-square&label=Chrome%20Users&labelColor=black&color=blue
  215. [firefox-store-link]: https://addons.mozilla.org/firefox/addon/tactus
  216. [firefox-version-shield]: https://img.shields.io/amo/v/tactus?style=flat-square&label=Firefox&labelColor=black&color=orange
  217. [firefox-users-shield]: https://img.shields.io/amo/users/tactus?style=flat-square&label=Firefox%20Users&labelColor=black&color=orange

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.