Arc-code

AI-powered coding CLI with Arc 3.4 Ultra.

Arc-code is an agentic coding assistant that runs in your terminal. It can read files, write code, search your workspace, and run shell commands — all through a single conversational interface.

Install

One command. Works on Windows, Mac, and Linux. Node.js is installed automatically if you don't have it.

Mac / Linux:

curl -fsSL https://github.com/artsblr-bot/arc-code/releases/download/v0.1.4/install.sh | bash

Windows (PowerShell):

iwr -useb https://github.com/artsblr-bot/arc-code/releases/download/v0.1.4/install.ps1 | iex

Then run:

arc

Features

• Arc 3.4 Ultra model with extended thinking, always on.
• Five focused tools: read_file, write_file, list_directory, search_files, execute_command.
• Orange-themed TUI inspired by Claude Code, with a tiny lightning-bug mascot.
• Animated thinking indicator: spinner + rotating status word + progress bar.
• Auto-compaction: long conversations are summarised so the context window never overflows.
• Single key hardcoded for the build. Nothing about the underlying provider appears in the CLI output.

Install

npm install
npm run build

Run

# interactive TUI
npm start

# or directly
node bin/arc.js start

# non-interactive single prompt
node bin/arc.js start -q "what does this project do?"

# in a different directory
node bin/arc.js start -d /path/to/project

Commands inside the TUI

• Type a message, press Enter to send.
• Ctrl+C to exit.

Tests

npm test          # runs both smoke + TUI smoke
npm run test:smoke
npm run test:tui

Project layout

src/
  config.ts          # encoded key + model constants
  state.ts           # state manager
  llm/
    provider.ts      # upstream chat client
    system.ts        # Arc 3.4 Ultra system prompt
    compaction.ts    # context-window compactor
    types.ts         # shared LLM types
  tools/
    read.ts          # read_file
    write.ts         # write_file
    list.ts          # list_directory
    search.ts        # search_files (ripgrep + fallback)
    execute.ts       # execute_command
  agent/
    orchestrator.ts  # main reasoning loop
    planner.ts       # step planner
    executor.ts      # tool dispatch
    verifier.ts      # output validation
    retriever.ts     # simple RAG over the workspace
    memory.ts        # long-term fact store
  ui/
    tui.tsx          # main Ink app
    theme.ts         # orange palette
    mascot.tsx       # lightning-bug art
    ChatWindow.tsx   # conversation log
    ThinkingIndicator.tsx  # spinner + word + progress bar
    InputBar.tsx     # prompt input
    words.ts         # ~150 rotating status words

Notes

• Thinking mode is always enabled. There is no command-line flag to turn it off.
• The model identifies itself as Arc 3.4 Ultra if asked.
• The key is encoded as char-code arrays in src/config.ts so the full string does not appear in the compiled binary.