Artificial Code ac

An AI coding agent with a beautiful terminal UI, powered by Mistral AI.

npm install -g artificial-code
ac

Features

• Beautiful TUI — Modern terminal interface with rich formatting
• Powerful tools — Read/write files, run shell commands, search code
• Approval system — All destructive operations require explicit approval
• Mistral Small — Fast and capable model, optimized for coding tasks
• Zero config — Just provide your Mistral API key and start coding

Setup

ac --setup

You'll be prompted for your Mistral API key.

Usage

ac                          # Start interactive session
ac "explain this codebase"  # Start with a message
ac --setup                  # Re-run setup
ac --cwd /path/to/project   # Set working directory

Available Tools

| Tool | Description | Requires Approval | |------|-------------|-------------------| | read_file | Read file contents with optional line range | No | | write_file | Write content to a file | Yes | | edit_file | Make targeted edits to a file | Yes | | bash | Execute shell commands | Yes | | list_files | List directory contents | No | | search_code | Search for patterns across files | No | | glob | Find files by glob pattern | No |

Keyboard Shortcuts

| Key | Action | |-----|--------| | Enter | Send message | | Ctrl+C | Exit | | ←/→ or Tab | Switch approval options | | Esc | Deny tool approval |

Commands

| Command | Description | |---------|-------------| | /clear | Clear conversation history | | /help | Show available commands | | /exit | Exit Artificial Code |

Security

• Shell commands always require user approval before execution
• File writes and edits require approval
• Irreversibly destructive commands (e.g., rm -rf /) are blocked entirely
• API key stored securely in OS user config directory

License

MIT