onecode-cli 0.1.3

AI-powered analysis and refactoring in natural language.

OneCode

Talk to your code. Let AI understand, refactor, and improve it.

Have a codebase that needs analysis? Want to refactor without getting lost in the details? OneCode is your AI assistant for code.

Point OneCode at any project folder, and ask it anything:

• 🤔 "What does this authentication flow do?"
• ✏️ "Add input validation to the login function"
• 🔍 "Where is the database connection code?"
• 🧪 "Write a test for this function and run it"
• 📁 "Move all test files to a tests/ directory"

No complex commands. No context switching. Just natural conversation.

---

Why OneCode?

Problem	Solution
Understanding unfamiliar codebases	Semantic search + AI analysis
Time-consuming refactoring	AI-powered code modification
Manual testing & debugging	Automated test generation & self-correction
Context switching between tools	Single natural language interface
Code maintenance at scale	Intelligent file operations & git integration

---

Installation

From PyPI:

pip install onecode-cli

---

Setup

1. Configure environment

Provide API keys using one of two methods:

Method A: Create .env file Add API keys to .env in your project or home directory. OPENAI_API_KEY is always required (used for embeddings):

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...   # only needed for Claude models

Method B: Export environment variables

export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...   # only needed for Claude models

---

How to run

After installation, the onecode command is available globally:

# Default model (claude-sonnet-4-6) with explicit path
onecode ~/path/to/project

# Use current directory (default if no path specified)
onecode

# Specify a different model
onecode --model gpt-4o

# From within the codebase directory (same as above)
cd ~/myproject
onecode

First installation check:

onecode --help

First run — output looks like this:

$ onecode ~/myproject
OneCode - Codebase Analyzer
----------------------------------------
Model:    claude-sonnet-4-6
Indexing: /Users/you/myproject
Ready:    42 nodes (class:12, file:18, function:12) | 42 embeddings

Type a question or task (or 'exit' to quit).
----------------------------------------

You: 

Subsequent runs — output looks like this:

$ onecode ~/myproject
OneCode - Codebase Analyzer
----------------------------------------
Model:    claude-sonnet-4-6
Indexing: /Users/you/myproject
Ready:    42 nodes (class:12, file:18, function:12) | 42 embeddings

Type a question or task (or 'exit' to quit).
----------------------------------------

You: 

---

Example queries

Understand the codebase

You: what does this codebase do?
You: explain the authentication flow
You: what classes exist and what are their responsibilities?
You: how does the database connection work?
You: analyze the modules in this codebase
You: what agents/modules are in this project?

Find specific code

You: search for all calls to connect_db
You: search for TODO comments
You: where is the retry logic implemented?
You: find all async functions

Write and modify code

You: add input validation to the login function
You: write a utility function that paginates a list and add it to utils.py
You: refactor the parse_config function to handle missing keys gracefully

Write, run, and self-correct

You: create a function that reverses a string, write a test for it, and run the test
You: add a health check endpoint and run the server to verify it starts
You: write a script that counts lines of code per file and run it

File management

You: rename src/helpers.py to src/utils.py
You: delete the tmp/ directory
You: move all test files into a tests/ directory

Git operations

You: show git status
You: show the diff of uncommitted changes
You: commit all staged files with message "add retry logic"
You: show the last 5 commits

Evaluate code quality with RAGAS metrics

You: evaluate the codebase
You: quick evaluation of reader agent focusing on faithfulness
You: what is the accuracy of the coder agent?
You: comprehensive evaluation of all modules

OneCode can evaluate any module using RAGAS metrics:

• Faithfulness — How faithful is the output to the context
• Answer Relevancy — How relevant the output is to the input
• Context Precision — How much of the context is relevant
• Context Recall — How much of relevant context was retrieved
• Agent Goal Accuracy — How accurately the agent achieved its goal
• Tool Call F1 — Precision and recall of tool calls made by agents

Use quick for fast evaluation (2 samples) or comprehensive for detailed analysis (10 samples).