fss-link 1.7.7 → 1.9.2

package/README.md

@@ -1,12 +1,12 @@
 # FSS Link
 
-A CLI coding agent forked from QwenCode, rebuilt around local-first model support and practical tooling for a solo developer's workflow.
+**FSS Link** is a terminal-based AI coding agent built for local-first model support and practical tooling in a solo developer's workflow. It reads your codebase, runs tools, and helps you build software — connecting to local models (LM Studio, vLLM) or cloud APIs (OpenAI, Gemini) with full access to file operations, web scraping, search, and shell commands.
 
 ## What it does
 
 FSS Link is a terminal-based AI assistant that reads your codebase, runs tools, and helps you build software. It connects to local models (LM Studio, vLLM) or cloud APIs (OpenAI, Gemini) and gives the model access to file operations, web scraping, search, and shell commands.
 
-It exists because the upstream project assumed cloud-only usage. This fork adds:
+Key capabilities include:
 
 - **Local model priority** — LM Studio and vLLM as first-class providers, not afterthoughts
 - **Database-backed model config** — switch models via CLI flags, settings persist across sessions
@@ -29,11 +29,20 @@ npm install -g fss-link
 git clone https://github.com/FSScoding/fss-link.git
 cd fss-link
 npm install
-npm run build
 npm run bundle
 sudo npm install -g .
 ```
 
+### First run — bootstrap the database
+
+The database (`~/.fss-link/fss-link.db`) is created on the **first command that needs it**, not during `npm install`. If `fss-link` fails with "Database directory not found" or "Cannot save database", run:
+
+```bash
+fss-link --version
+```
+
+This is the quickest way to bootstrap everything — it creates the directory, initialises the schema, and inserts default model configs. After that, `fss-link` (interactive) and `fss-link -p "..."` will work normally.
+
 ## Usage
 
 ```bash
@@ -59,6 +68,7 @@ fss-link -p "fix the failing tests" --approval-mode yolo
 | `/auth` | Set up authentication method and model |
 | `/model` | Switch between available models |
 | `/theme` | Change the UI theme |
+| `/permissions` | Manage project-scoped shell permissions (list, revoke) |
 | `/help` | List all available slash commands |
 
 ### Providers
@@ -66,11 +76,12 @@ fss-link -p "fix the failing tests" --approval-mode yolo
 | Provider | Flag | Notes |
 |---|---|---|
 | LM Studio | `--provider lm-studio` | Local, port 1234 |
-| vLLM / OpenAI-compatible | `--provider ollama` | Local or network |
+| vLLM / OpenAI-compatible | `--provider bob-ai` | Local or network |
 | OpenAI | `--provider openai-api-key` | Requires `OPENAI_API_KEY` |
 | Gemini | `--provider gemini-api-key` | Requires `GEMINI_API_KEY` |
 | BobAI Proxy | `--provider bob-ai` | Custom proxy endpoint |
 | Vertex AI | `--provider vertex-ai` | Google Cloud |
+| Qwen OAuth | `--provider qwen-oauth` | Built-in OAuth flow |
 
 Model and provider settings persist to a local SQLite database. Once set, you don't need to specify them again.
 
@@ -107,7 +118,7 @@ esbuild bundles directly from TypeScript source into `bundle/fss-link.js`. Do no
 
 ## Current version
 
-v1.7.7 — see [CHANGELOG.md](./CHANGELOG.md) for history.
+v1.9.1 — see [CHANGELOG.md](./CHANGELOG.md) for history.
 
 ## License
 
@@ -115,4 +126,4 @@ v1.7.7 — see [CHANGELOG.md](./CHANGELOG.md) for history.
 
 ## Acknowledgments
 
-FSS Link is a hard fork of [QwenCode](https://github.com/QwenLM/qwen-code), which builds on [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+FSS Link traces its origins to [QwenCode](https://github.com/QwenLM/qwen-code), which itself builds on [Google Gemini CLI](https://github.com/google-gemini/gemini-cli). The two projects have since diverged significantly — FSS Link has evolved independently with a different architecture, tool set, and direction.