Skip to content

πŸ”₯ Teachable AI desktop assistant with agentic skill execution β€” teach any workflow via chat, auto-route & run tools (shell, file, HTTP). Built with Tauri 2, Rust & React. Supports OpenAI, DeepSeek, Ollama & any LLM API.

License

Notifications You must be signed in to change notification settings

novaair026-dev/ChiefForge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ChiefForge

AI That Learns Your Skills

A next-generation desktop AI assistant you can teach. Describe any workflow in natural language, and ChiefForge turns it into an executable skill β€” forever.

Download Platform

Rust Β· Tauri v2 Β· React 19 Β· TypeScript Β· SQLite


Screenshots

Chat Mode

Chat Mode β€” Intelligent conversations powered by your custom skills. Type a message and the AI automatically activates the right skill to help.

Teach Mode

Teach Mode β€” Describe any workflow and the AI learns it instantly. Skills are saved locally and persist across sessions.


Why ChiefForge?

Most AI assistants are frozen at release. They can't learn new tricks.

ChiefForge is different. You teach it skills through conversation. It remembers them. It uses them automatically. The more you teach, the smarter it gets β€” tailored entirely to your workflow.

Teach once. Use forever.


Features

Skill Learning Engine

Teach the AI any workflow through natural conversation. Describe what you want β€” the AI asks clarifying questions, then generates a structured, reusable skill definition automatically. No code required.

Intelligent Routing

Every message is analyzed in real-time. The AI automatically selects and activates the most relevant skills from your library. No manual skill selection, no menus β€” just ask and the right skill fires.

Agentic Execution

Skills aren't just definitions β€” they come alive. The AI runs shell commands, reads/writes files, and makes HTTP requests in an autonomous loop until the task is complete. Results stream back in real-time.

Cross-Platform

Built on Tauri v2, ChiefForge runs natively on macOS, Windows, and Linux with a tiny bundle size and low memory footprint. One codebase, three platforms.

Sandboxed Safety

Every tool execution runs within a configurable sandbox. Blocked commands, timeout guards, and file size limits keep your system safe while giving the AI the power to act.

Rich Rendering

Full Markdown with syntax-highlighted code blocks, LaTeX math via KaTeX, and streaming token-by-token responses. A polished conversational experience.


How It Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚         β”‚         β”‚         β”‚         β”‚         β”‚
β”‚  TEACH  β”‚ ──────▢ β”‚  ROUTE  β”‚ ──────▢ β”‚ EXECUTE β”‚
β”‚         β”‚         β”‚         β”‚         β”‚         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
 Describe a          AI analyzes         Skill runs
 skill in            your message        tools auto-
 plain text          and picks the       matically:
 β€” the AI            right skill         shell, file
 learns it           from your           I/O, HTTP
 instantly.          library.            requests.

Step 1 β€” Teach: Open Teach mode and describe the skill you want. The AI asks questions, then generates a complete skill definition with tools, parameters, and system prompts.

Step 2 β€” Route: Switch to Chat mode and send a message. The skill router analyzes your intent and automatically activates the most relevant skill β€” no manual selection needed.

Step 3 β€” Execute: The skill's tools run autonomously in an agentic loop. Shell commands, file operations, HTTP calls β€” all streamed back in real-time until the task is done.


Tech Stack

Layer Technology Purpose
Backend Rust Core logic, performance, safety
Framework Tauri v2 Native desktop, cross-platform
Frontend React 19 + TypeScript UI components, state management
Styling Tailwind CSS v4 Dark theme, responsive design
Database SQLite (sqlx) Skills, conversations, settings
Build Vite Fast HMR, optimized bundles
AI OpenAI-compatible API Chat completions, streaming
Math KaTeX LaTeX formula rendering

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    Tauri v2 Shell                     β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  React Frontend   β”‚         Rust Backend             β”‚
β”‚                   β”‚                                  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚ ChatPanel   β”‚  β”‚  β”‚  Engine  │───│   Router   β”‚  β”‚
β”‚  β”‚ TeachPanel  │◀─┼─▢│ (agentic β”‚   β”‚ (skill     β”‚  β”‚
β”‚  β”‚ SkillsList  β”‚  β”‚  β”‚  loop)   β”‚   β”‚  matching) β”‚  β”‚
β”‚  β”‚ Settings    β”‚  β”‚  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚       β”‚                          β”‚
β”‚                   β”‚  β”Œβ”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚                   β”‚  β”‚ Executor  β”‚   β”‚  Learner   β”‚  β”‚
β”‚                   β”‚  β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β” β”‚   β”‚ (teach     β”‚  β”‚
β”‚                   β”‚  β”‚ β”‚ shell β”‚ β”‚   β”‚  mode)     β”‚  β”‚
β”‚                   β”‚  β”‚ β”‚ file  β”‚ β”‚   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚                   β”‚  β”‚ β”‚ http  β”‚ β”‚                    β”‚
β”‚                   β”‚  β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚                   β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β”‚   SQLite   β”‚  β”‚
β”‚                   β”‚                  β”‚  Database   β”‚  β”‚
β”‚                   β”‚                  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚               macOS / Windows / Linux                β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Quick Start

Download & Install

Head to the Releases page and download the installer for your platform:

Platform File Note
macOS ChiefForge_x.x.x_aarch64.dmg Apple Silicon (M1/M2/M3/M4)
macOS ChiefForge_x.x.x_x64.dmg Intel Mac
Windows ChiefForge_x.x.x_x64-setup.exe 64-bit Windows 10/11

macOS users: If prompted with "unidentified developer", right-click the app β†’ Open β†’ Open to bypass Gatekeeper.

Double-click the downloaded file to install, then launch ChiefForge from your Applications folder (macOS) or Start Menu (Windows).


Configuration

On first launch, open Settings (gear icon) and configure:

Setting Description
API Base URL Your OpenAI-compatible API endpoint
API Key Your API key for authentication
Model Model name (e.g., gpt-4o, deepseek-chat)

ChiefForge works with any OpenAI-compatible API: OpenAI, Azure OpenAI, DeepSeek, Ollama, LM Studio, and more.


Skill Example

Here's what a skill definition looks like under the hood:

{
  "name": "Text to Speech",
  "description": "Read text aloud using system speech synthesis",
  "system_prompt": "You are a text-to-speech assistant. Use the say_text tool to read text aloud.",
  "tools": [
    {
      "name": "say_text",
      "description": "Speak text using system TTS",
      "tool_type": "shell",
      "parameters": {
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "description": "The say command to execute"
          }
        },
        "required": ["command"]
      }
    }
  ],
  "tags": ["audio", "tts", "speech"]
}

You don't write this JSON β€” the AI generates it through conversation in Teach mode.


Feedback & Support

Have questions or found a bug? We'd love to hear from you:


License

This project is proprietary software. All rights reserved. See LICENSE for details.


Download Β· Report Bug

Built with Rust & React β€” by the ChiefForge team.

About

πŸ”₯ Teachable AI desktop assistant with agentic skill execution β€” teach any workflow via chat, auto-route & run tools (shell, file, HTTP). Built with Tauri 2, Rust & React. Supports OpenAI, DeepSeek, Ollama & any LLM API.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published