@agiflowai/agent-cli 0.0.7 → 0.0.9

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.0.9
+Update:
+- Improve Claude Code tool permissions detection.
+
+## 0.0.8
+Update:
+- Add `claude --standalone` command to support launching claude without backend connection.
+
 ## 0.0.7
 Add:
 - Add `router` command to enable switching provider to openai chatgpt sub.

package/README.md

@@ -6,7 +6,9 @@
 
 @agiflowai/agent-cli - Command-line interface for connecting and managing AI agents (Claude Code, Gemini) with Agiflow remotely.
 
-**Note**: for `agent-cli claude` and `agent-cli router` you don't need to authenticate with Agiflow server.
+**Note**:
+- For `agent-cli claude` and `agent-cli router` you don't need to authenticate with Agiflow server.
+- Use `agent-cli claude --standalone` to run Claude Code locally without any backend connection.
 
 **🔗 Related Project**: Check out the [AgiFlow AI Code Toolkit](https://github.com/AgiFlow/aicode-toolkit) - an open-source collection of AI development tools and utilities.  
 
@@ -51,7 +53,10 @@ agent-cli connect --verbose
 Launch a Claude Code agent with full functionality.
 
 ```bash
-# Basic Claude agent launch (requires session ID)
+# Basic Claude agent launch in standalone mode (no backend)
+agent-cli claude --standalone
+
+# With backend connection (requires session ID)
 agent-cli claude --agent-session-id your-session-id
 
 # With custom alias for easy identification
@@ -71,6 +76,9 @@ agent-cli claude \
   --llm-provider chatgpt \
   --llm-model gpt-5 \
   --alias "gpt5-experiment"
+
+# Standalone mode (no backend connection)
+agent-cli claude --standalone --verbose
 ```
 
 **Options:**
@@ -85,6 +93,7 @@ agent-cli claude \
 - `--args <args...>` - Additional arguments to pass to Claude
 - `-v, --verbose` - Enable verbose logging
 - `--alias <alias>` - Custom session alias for easy identification
+- `--standalone` - Run in standalone mode without backend connection
 
 **LLM Routing Options:**
 - `--llm-provider <provider>` - LLM provider to route requests to (e.g., `chatgpt`, `openai`)
@@ -92,6 +101,39 @@ agent-cli claude \
 
 **Note:** LLM routing configuration is saved to `~/.agiflow/sessions.json` and can be changed later using the `agent-cli router` command without restarting the agent.
 
+##### Standalone Mode
+
+Run Claude Code agent locally without connecting to the Agiflow backend server. This is useful for:
+- Development and testing
+- Running in environments without backend access
+- Privacy-focused local-only usage
+
+**Usage:**
+
+```bash
+# Explicit standalone mode
+agent-cli claude --standalone
+
+# Standalone mode with verbose logging
+agent-cli claude --standalone --verbose
+
+# Standalone mode with custom working directory
+agent-cli claude --standalone --working-directory /path/to/project
+```
+
+**How It Works:**
+
+When `--standalone` is enabled:
+- ✅ Claude Code launches normally with full functionality
+- ✅ All local features work (file operations, code analysis, etc.)
+- ❌ No WebSocket connection to Agiflow backend
+- ❌ No remote session management
+- ❌ No backend authentication required
+
+**Automatic Standalone Detection:**
+
+If no server URL is configured (via `--server-url` or environment variables), the agent automatically runs in standalone mode even without the `--standalone` flag.
+
 ##### Running Claude with ChatGPT/OpenAI
 
 You can route Claude Code requests to ChatGPT/OpenAI using the LLM routing feature. This allows you to use GPT models while keeping the Claude Code interface.
@@ -313,6 +355,16 @@ agent-cli logout --verbose
    - Check network connectivity
    - Verify server URL is accessible
    - Use `--verbose` flag for detailed logging
+   - Use `--standalone` flag to run without backend connection
+
+5. **WebSocket 401 Unauthorized (Production)**
+   ```
+   Error: Unexpected server response: 401
+   ```
+   Solution: Use `--standalone` flag to run without backend authentication:
+   ```bash
+   agent-cli claude --standalone --verbose
+   ```
 
 **LLM Routing Issues:**