feat: add UniFFI bindgen and feature-gate ClaudeCliProvider for mobile

- Add uniffi-bindgen binary to mobile crate for Swift/Kotlin binding
  generation (validated: produces ~40KB Swift + Kotlin files)
- Feature-gate ClaudeCliProvider behind `claude-cli` feature (default on
  for desktop, excluded on mobile) since it requires subprocess execution
  not available on iOS/Android
- Add `claude-cli` feature to localgpt-core default features
- Fix AgentHandle Send+Sync assertion to avoid dead_code warnings
- Update CLAUDE.md with binding generation commands and feature docs

Author: yiwang

CLAUDE.md

@@ -72,15 +72,16 @@ localgpt-gen    ──→ localgpt-core
 Platform-independent library. Compiles for iOS/Android targets.
 
 - **agent/** - LLM interaction layer
-  - `providers.rs` - Trait `LLMProvider` with implementations for OpenAI, Anthropic, Ollama, Claude CLI, and GLM (Z.AI). Model prefix determines provider (`claude-cli/*` → Claude CLI, `gpt-*` → OpenAI, `claude-*` → Anthropic API, `glm-*` → GLM, else Ollama)
+  - `providers.rs` - Trait `LLMProvider` with implementations for OpenAI, Anthropic, Ollama, Claude CLI (feature-gated: `claude-cli`), and GLM (Z.AI). Model prefix determines provider (`claude-cli/*` → Claude CLI, `gpt-*` → OpenAI, `claude-*` → Anthropic API, `glm-*` → GLM, else Ollama)
   - `session.rs` - Conversation state with automatic compaction when approaching context window limits
   - `session_store.rs` - Session metadata store (`sessions.json`) with CLI session ID persistence
   - `system_prompt.rs` - Builds system prompt with identity, safety, workspace info, tools, skills, and special tokens
   - `skills.rs` - Loads SKILL.md files from workspace/skills/ for specialized task handling
   - `tools/mod.rs` - Safe tools only: `memory_search`, `memory_get`, `web_fetch`, `web_search`
   - `AgentHandle` - Thread-safe `Arc<tokio::sync::Mutex<Agent>>` wrapper for mobile/server use
 - **memory/** - Markdown-based knowledge store (SQLite FTS5, file watcher, workspace templates)
-  - Feature-gated: `embeddings-local` (fastembed/ONNX, default), `embeddings-openai`, `embeddings-gguf`, `embeddings-none`
+  - Feature-gated embeddings: `embeddings-local` (fastembed/ONNX, default), `embeddings-openai`, `embeddings-gguf`, `embeddings-none`
+  - Feature-gated provider: `claude-cli` (default) — subprocess-based Claude CLI; excluded on mobile
 - **heartbeat/** - Autonomous task runner on configurable interval
 - **config/** - TOML configuration at `~/.localgpt/config.toml`. `Config::load()` for desktop, `Config::load_from_dir()` for mobile
 - **commands.rs** - Shared slash command definitions used by CLI and Telegram
@@ -283,13 +284,30 @@ Plus any skill slash commands (e.g., `/github-pr`, `/commit`) based on installed
 
 ## Mobile Development
 
+### Generate Bindings (dev machine)
+
+```bash
+# Build the mobile crate (includes uniffi-bindgen binary)
+cargo build -p localgpt-mobile
+
+# Generate Swift bindings
+target/debug/uniffi-bindgen generate \
+  --library target/debug/liblocalgpt_mobile.dylib \
+  --language swift --out-dir mobile/ios/Generated
+
+# Generate Kotlin bindings
+target/debug/uniffi-bindgen generate \
+  --library target/debug/liblocalgpt_mobile.dylib \
+  --language kotlin --out-dir mobile/android/Generated
+```
+
 ### iOS
 
 ```bash
 # Prerequisites
 rustup target add aarch64-apple-ios aarch64-apple-ios-sim
 
-# Build and generate Swift bindings
+# Build and generate Swift bindings + XCFramework
 cd mobile/ios/scripts
 ./build-rust.sh          # Release build (default)
 ./build-rust.sh debug    # Debug build

Cargo.lock

@@ -7,9 +7,11 @@ repository.workspace = true
 description = "Core library for LocalGPT — agent, memory, config, security"
 
 [features]
-default = ["embeddings-local"]
+default = ["embeddings-local", "claude-cli"]
 # Local embeddings via fastembed (ONNX). Desktop default.
 embeddings-local = ["fastembed"]
+# Claude CLI provider (requires subprocess execution — not available on mobile)
+claude-cli = []
 # GGUF embedding model support via llama.cpp (requires C++ compiler)
 embeddings-gguf = ["llama-cpp-2"]
 # OpenAI API embeddings (no native deps, always works on mobile)

crates/core/Cargo.toml

@@ -1230,13 +1230,11 @@ pub struct AgentHandle {
     inner: Arc<tokio::sync::Mutex<Agent>>,
 }
 
-// Compile-time guarantee that AgentHandle is safe to share across threads.
-const _: () = {
-    fn assert_send_sync<T: Send + Sync>() {}
-    fn check() {
-        assert_send_sync::<AgentHandle>();
-    }
-};
+// Compile-time assertion: AgentHandle must be Send + Sync.
+fn _assert_agent_handle_is_send_sync() {
+    fn require_send_sync<T: Send + Sync>() {}
+    require_send_sync::<AgentHandle>();
+}
 
 impl AgentHandle {
     /// Create a new handle wrapping an existing Agent.

crates/core/src/agent/mod.rs

@@ -6,10 +6,16 @@ use reqwest::Client;
 use serde::{Deserialize, Serialize};
 use serde_json::{Value, json};
 use std::pin::Pin;
+#[cfg(feature = "claude-cli")]
 use std::process::Stdio;
+#[cfg(feature = "claude-cli")]
 use std::sync::Mutex as StdMutex;
+#[cfg(feature = "claude-cli")]
 use tokio::io::{AsyncBufReadExt, BufReader};
+#[cfg(feature = "claude-cli")]
 use tracing::{debug, info};
+#[cfg(not(feature = "claude-cli"))]
+use tracing::debug;
 
 use crate::config::Config;
 
@@ -216,6 +222,7 @@ fn normalize_model_id(provider: &str, model_id: &str) -> String {
 }
 
 pub fn create_provider(model: &str, config: &Config) -> Result<Box<dyn LLMProvider>> {
+    #[cfg(feature = "claude-cli")]
     let workspace = config.workspace_path();
 
     // Resolve aliases first (e.g., "opus" → "anthropic/claude-opus-4-5")
@@ -279,13 +286,21 @@ pub fn create_provider(model: &str, config: &Config) -> Result<Box<dyn LLMProvid
             )?))
         }
 
+        #[cfg(feature = "claude-cli")]
         "claude-cli" => {
             let cli_config = config.providers.claude_cli.as_ref();
             let command = cli_config.map(|c| c.command.as_str()).unwrap_or("claude");
             Ok(Box::new(ClaudeCliProvider::new(
                 command, &model_id, workspace,
             )?))
         }
+        #[cfg(not(feature = "claude-cli"))]
+        "claude-cli" => {
+            anyhow::bail!(
+                "Claude CLI provider is not available in this build.\n\
+                 The 'claude-cli' feature is required for subprocess-based providers."
+            )
+        }
 
         "ollama" => {
             let ollama_config = config.providers.ollama.as_ref().ok_or_else(|| {
@@ -322,6 +337,7 @@ pub fn create_provider(model: &str, config: &Config) -> Result<Box<dyn LLMProvid
 
         _ => {
             // Fallback: try Claude CLI if configured
+            #[cfg(feature = "claude-cli")]
             if let Some(cli_config) = &config.providers.claude_cli {
                 return Ok(Box::new(ClaudeCliProvider::new(
                     &cli_config.command,
@@ -1258,6 +1274,7 @@ impl LLMProvider for OllamaProvider {
     }
 }
 
+#[cfg(feature = "claude-cli")]
 /// Claude CLI Provider - invokes the `claude` CLI command
 /// No tool support (text in → text out only)
 /// No streaming (CLI output is collected then returned)
@@ -1274,9 +1291,11 @@ pub struct ClaudeCliProvider {
     cli_session_id: StdMutex<Option<String>>,
 }
 
+#[cfg(feature = "claude-cli")]
 /// Provider name for CLI session storage
 const CLAUDE_CLI_PROVIDER: &str = "claude-cli";
 
+#[cfg(feature = "claude-cli")]
 impl ClaudeCliProvider {
     pub fn new(command: &str, model: &str, workspace: std::path::PathBuf) -> Result<Self> {
         // Load existing CLI session from session store
@@ -1452,6 +1471,7 @@ impl ClaudeCliProvider {
     }
 }
 
+#[cfg(feature = "claude-cli")]
 /// Load CLI session ID from session store
 fn load_cli_session_from_store(session_key: &str, provider: &str) -> Option<String> {
     use super::session_store::SessionStore;
@@ -1460,6 +1480,7 @@ fn load_cli_session_from_store(session_key: &str, provider: &str) -> Option<Stri
     store.get_cli_session_id(session_key, provider)
 }
 
+#[cfg(feature = "claude-cli")]
 /// Save CLI session ID to session store
 fn save_cli_session_to_store(
     session_key: &str,
@@ -1474,6 +1495,7 @@ fn save_cli_session_to_store(
     Ok(())
 }
 
+#[cfg(feature = "claude-cli")]
 fn normalize_claude_model(model: &str) -> String {
     match model.to_lowercase().as_str() {
         "opus" | "opus-4.5" | "opus-4" | "claude-opus-4-5" => "opus",
@@ -1484,6 +1506,7 @@ fn normalize_claude_model(model: &str) -> String {
     .to_string()
 }
 
+#[cfg(feature = "claude-cli")]
 /// Check if a message is the synthetic security block appended by `messages_for_api_call`.
 fn is_security_block(msg: &Message) -> bool {
     msg.role == Role::User
@@ -1492,6 +1515,7 @@ fn is_security_block(msg: &Message) -> bool {
             .contains(crate::security::HARDCODED_SECURITY_SUFFIX)
 }
 
+#[cfg(feature = "claude-cli")]
 fn build_prompt_from_messages(messages: &[Message]) -> String {
     // Get the last *real* user message as the prompt, skipping the security block
     messages
@@ -1502,6 +1526,7 @@ fn build_prompt_from_messages(messages: &[Message]) -> String {
         .unwrap_or_default()
 }
 
+#[cfg(feature = "claude-cli")]
 fn extract_system_prompt(messages: &[Message]) -> Option<String> {
     let system = messages
         .iter()
@@ -1524,6 +1549,7 @@ fn extract_system_prompt(messages: &[Message]) -> Option<String> {
     }
 }
 
+#[cfg(feature = "claude-cli")]
 /// Parse Claude CLI JSON output, returning (response_text, session_id)
 fn parse_claude_cli_output(stdout: &str) -> Result<(String, Option<String>)> {
     // Claude CLI outputs JSON with message content and session info
@@ -1553,6 +1579,7 @@ fn parse_claude_cli_output(stdout: &str) -> Result<(String, Option<String>)> {
     Ok((stdout.trim().to_string(), None))
 }
 
+#[cfg(feature = "claude-cli")]
 #[async_trait]
 impl LLMProvider for ClaudeCliProvider {
     fn reset_session(&self) {

crates/core/src/agent/providers.rs

@@ -10,9 +10,13 @@ description = "LocalGPT mobile bindings via UniFFI"
 crate-type = ["staticlib", "cdylib"]
 name = "localgpt_mobile"
 
+[[bin]]
+name = "uniffi-bindgen"
+path = "uniffi-bindgen.rs"
+
 [dependencies]
 localgpt-core = { path = "../core", default-features = false, features = ["embeddings-openai"] }
-uniffi = "0.29"
+uniffi = { version = "0.29", features = ["cli"] }
 tokio = { workspace = true }
 anyhow = { workspace = true }
 thiserror = { workspace = true }

crates/mobile/Cargo.toml

@@ -0,0 +1,3 @@
+fn main() {
+    uniffi::uniffi_bindgen_main()
+}

crates/mobile/uniffi-bindgen.rs

@@ -5,6 +5,7 @@ ios/build/
 ios/DerivedData/
 
 # Android build artifacts
+android/Generated/
 android/.gradle/
 android/build/
 android/app/build/