fss-link 1.3.0 → 1.4.1

package/README.md

@@ -12,17 +12,17 @@
 
 </div>
 
-**FSS Link** is a portable, scriptable agent that links tools, models, and knowledge into multi-instance workflows. Install anywhere with Node.js, launch 1-8 agents at once, feed them templated tasks, and watch them go.
+**FSS Link** is a portable, scriptable agent that links tools, models, and knowledge into single-instance workflows. Install anywhere with Node.js, launch one agent at a time, feed it tasks, and watch it go.
 
 - **Lightweight distribution** (~15 MB bundle, requires Node.js 20+)
-- **Spawn many agents** with structured prompts  
-- **Portable Mini-RAG** indices that travel with your projects
+- **Single-agent workflows** with structured prompts  
+- **Portable Mini-RAG** indices that travel with your projects (planned feature)
 - **Local-first** with LM Studio/Ollama priority
 - **Professional tools** built in TypeScript for seamless integration
 
 ## 🎯 Why "Link"?
 
-Link connects things—tools, models, tasks, and knowledge. **FSS Link** is a lightweight distribution that runs wherever Node.js is installed. Start an agent, or spawn eight in parallel with templated prompts. Each project carries its own Mini-RAG index, so knowledge travels with the work.
+Link connects things—tools, models, tasks, and knowledge. **FSS Link** is a lightweight distribution that runs wherever Node.js is installed. Start an agent, or spawn multiple agents with templated prompts (planned feature). Each project carries its own Mini-RAG index, so knowledge travels with the work.
 
 ## 🚀 Quick Start
 
@@ -33,10 +33,7 @@ fss-link
 # Single-shot task
 fss-link run "Audit the repo for security keys and open PR fixes."
 
-# Launch 6 parallel agents with templated plan
-fss-link spawn --count 6 --template ./templates/regression.yml
-
-# Portable RAG - indexes travel with projects
+# Portable RAG - indexes travel with projects (planned feature)
 cd project && fss-link rag index . && fss-link rag query "error handling"
 ```
 
@@ -98,10 +95,17 @@ FSS Link now features an intelligent **Welcome Back dialog** that appears when y
 
 - **🔍 Project Status Dashboard** - Git status, session history, momentum analysis
 - **📊 Smart Context Generation** - Priority-based information filtering (7 levels)
-- **⚡ Multi-Agent Awareness** - Universal session tracking across all agents
+- **⚡ Multi-Agent Awareness** - Universal session tracking across all agents (planned feature)
 - **🎯 Seamless Resumption** - Intelligent context population for continuing work
 - **🚀 Production Quality** - Comprehensive error handling, performance optimization
 
+## 📁 External Directory Access
+
+For accessing external directories like `/tmp`, user directories, or custom paths, see:
+[External Directory Access Guide](./fss-docs/EXTERNAL-DIRECTORY-ACCESS.md)
+
+This documentation explains how to configure FSS Link to securely access external directories through its folder trust system.
+
 ### 🔄 **Node.js Version Requirements**
 
 FSS Link requires **Node.js 20+**. If you have an older version, upgrade first:
@@ -153,7 +157,7 @@ Built-in semantic search that travels with your projects. No Python dependencies
 - **Deep Semantic Search**: Find code by describing what it does, not just what it's called
 - **Cross-Reference Analysis**: Discover how different parts of the system interact
 - **Context-Aware Suggestions**: Get recommendations based on the entire project context
-- **Portable Indices**: Knowledge travels with your projects
+- **Portable Indices**: Knowledge travels with your projects (planned feature)
 
 ### 📋 **Enhanced Task Management**
 Built on FSS Link's native TodoWrite tool with professional enhancements for complex development workflows.
@@ -161,7 +165,7 @@ Built on FSS Link's native TodoWrite tool with professional enhancements for com
 - **Persistent Task Lists**: Never lose track of what needs to be done
 - **Visual Progress Indicators**: Instantly see what's complete, in-progress, or pending
 - **Intelligent Task Breakdown**: Automatically decompose complex features into actionable steps
-- **Multi-Agent Coordination**: Tasks shared across multiple agent instances
+- **Multi-Agent Coordination**: Tasks shared across multiple agent instances (planned feature)
 
 ### 🔍 **Professional Web Research**
 TypeScript-native web research tools eliminate context switching between development and external resources.
@@ -210,7 +214,7 @@ fss-link
 # Launch with specific model
 fss-link --model qwen/qwen3-4b-2507
 
-# Launch with RAG index
+# Launch with RAG index (planned feature)
 fss-link --rag ./project-index
 ```
 
@@ -222,34 +226,34 @@ fss-link run "Analyse this codebase structure"
 # With specific model
 fss-link run "Review security patterns" --model qwen/qwen3-30b-a3b-2507
 
-# With RAG context
+# With RAG context (planned feature)
 fss-link run "Find authentication bugs" --rag .
 ```
 
-### **Multi-Agent Workflows**
+### **Multi-Agent Workflows** (Planned Feature)
 ```bash
-# Launch multiple agents with template
+# Launch multiple agents with template (planned feature)
 fss-link spawn --count 8 --template ./templates/build-test.yml
 
-# Parallel code review
+# Parallel code review (planned feature)
 fss-link spawn --count 4 --template ./templates/code-review.yml --files src/
 
-# Load-balanced task processing
+# Load-balanced task processing (planned feature)
 fss-link spawn --count 6 --template ./templates/regression-test.yml
 ```
 
-### **RAG Operations**
+### **RAG Operations** (Planned Feature)
 ```bash
-# Index current directory
+# Index current directory (planned feature)
 fss-link rag index .
 
-# Index with specific extensions
+# Index with specific extensions (planned feature)
 fss-link rag index . --extensions py,js,md
 
-# Query with filters
+# Query with filters (planned feature)
 fss-link rag query "authentication logic" --topk 5
 
-# Cross-reference search
+# Cross-reference search (planned feature)
 fss-link rag query "error handling patterns" --files py,js --recent
 ```
 
@@ -338,8 +342,8 @@ FSS Link builds on [QwenLM/fss-link](https://github.com/QwenLM/fss-link), which
 
 <div align="center">
 
-**FSS Link** - *Portable, scriptable, multi-instance AI agent*
+**FSS Link** - *Portable, scriptable, single-instance AI agent*
 
 [Documentation](./FSS-LINK-IMPLEMENTATION-GUIDE.md) • [Installation Guide](./INSTALL.md) • [Examples](./examples/)
 
-</div>
+</div>