cspyridakis/aicode repository overview

⁠Ubuntu 24.04 AI CLI Toolbox (Homebrew-based)

Minimal Ubuntu image with Homebrew (Linuxbrew) and popular AI CLI tools preinstalled, running as a non-root user.

⁠Base Image

• Ubuntu 24.04

⁠Included Tools

Installed via Homebrew (Linuxbrew):

• gemini-cli⁠
• codex⁠
• claude-code⁠

Also includes common utilities:

• build-essential
• git
• curl
• jq / yq
• unzip
• tmux
• sudo
• procps

⁠User Model

• Non-root user: brewuser & ubuntu
• Default working directory: /workspace
• Default shell: /bin/bash

⁠Volumes

The following directories are designed to be persisted:

⁠Usage

⁠Run interactively

docker run -it --rm \
  -v "$PWD":/workspace \
  cspyridakis/aicode:latest

Or add something like this in your profile file:

function aicode(){
  docker run -it --rm \
    -u "$(id -u):$(id -g)" \
    -v "$PWD":/workspace \
    -v "$HOME/.aicode/shared":/home/ubuntu/.aicode \
    -v "$HOME/.aicode/config/codex":/home/ubuntu/.codex \
    -v "$HOME/.aicode/config/gemini":/home/ubuntu/.gemini \
    -v "$HOME/.aicode/config/claude":/home/ubuntu/.claude \
    cspyridakis/aicode:latest
}

⁠Default Behavior

• Starts in /workspace
• Opens an interactive Bash shell
• Runs as ubuntu
• AI tools available in PATH