Interintel

A CLI for local AI-assisted development. Chat with AI models running on your machine to read, search, edit files, and run commands—without sending your code to the cloud.

Features

• Local-first: Works with Ollama for fully local AI (no data leaves your machine)
• Multi-provider: Supports Ollama, OpenAI, and Mistral
• AI-driven tools: AI can read files, search code, edit files, and run commands
• Permission system: You control what the AI can do
• Fuzzy search: Natural language queries find chatCompletion, chat_completion, etc.

Requirements

• Node.js >= 18.0.0
• Ollama (for local AI) with a tool-capable model:
  • llama3.1:8b (recommended)
  • qwen2.5:7b
  • gpt-oss:20b

Installation

npm install interintel

Or clone and run locally:

git clone https://github.com/modern-sapien/interintel.git
cd interintel
npm install
node index.js

Configuration

After install, edit interintel.config.js in your project root:

export default {
  // 'ollama' | 'openai' | 'mistral'
  aiService: 'ollama',

  // Model name
  aiVersion: 'llama3.1:8b',

  // API key (only for OpenAI/Mistral)
  apiKey: process.env.OPENAI_API_KEY || '',

  // System prompt - customize AI behavior
  systemPrompt: 'You are a direct, focused coding assistant.',

  // Files to load into context
  filePaths: [],
};

Usage

interintel
# or
node index.js

Then chat naturally:

You: What files are in this project?
You: Find where fetchUser is defined
You: Update the version in package.json to 2.0.0
You: Run npm test

AI Tools

The AI has access to these tools:

| Tool | Description | Permission | |------|-------------|------------| | read_file | Read file contents | Allowed | | list_directory | List files/folders | Allowed | | search_directory | Search code with fuzzy matching | Allowed | | edit_file | Modify existing files | Requires permission | | write_file | Create new files | Requires permission | | run_command | Execute shell commands | Requires permission |

Permissions

Write and execute operations require your approval:

AI wants to write: src/index.js
[y]es (once) / [n]o / [a]lways (save) / [g]lobal (trust all writes):

• y - Allow once (session only)
• n - Deny
• a - Always allow this directory (saved)
• g - Trust all write operations (saved)

View permissions with //permissions. Settings saved in .interintel/interintel.permissions.json.

Commands

| Command | Description | |---------|-------------| | //plan <task> | Collaborative planning mode - discuss approach before executing | | //permissions | Show current permission settings | | //readrefs | Load reference files from config | | //writefile | AI-assisted file creation | | exit | Quit interintel |

File Structure

interintel/
├── index.js                # Entry point
├── setup.js                # Postinstall setup
├── src/
│   ├── cli.js              # Main CLI loop
│   ├── providers.js        # AI service interface (Ollama/OpenAI/Mistral)
│   ├── tools/
│   │   ├── definitions.json
│   │   ├── executors.js
│   │   ├── index.js
│   │   └── permissions.js
│   └── utils/
│       ├── chat.js         # Readline helpers
│       ├── files.js        # File operations
│       └── writeFileHandler.js
└── templates/
    └── config.js           # Config template

License

Apache-2.0