hub / github.com/AAAAAAAJ/WaytoAGI-CLI

github.com/AAAAAAAJ/WaytoAGI-CLI @main

Chat with this repo

repository ↗ · DeepWiki ↗ · + Follow

11,804 symbols 42,367 edges 1,905 files 1,595 documented · 14%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

WaytoAGI CLI

AI Community · Empowered by AI

Website · Installation · Usage · Features

WaytoAGI CLI is an agentic coding tool that lives in your terminal. It understands your codebase, writes code, fixes bugs, runs commands, and helps you build software — all through natural language.

Preview

6b6269018b70196760cebda1e314e256

╭─ WaytoAGI v1.0.0 ──────────────────────────────────────────────────╮
│                                                                      │
│  ██╗    ██╗ █████╗ ██╗   ██╗████████╗ ██████╗  █████╗  ██████╗ ██╗ │
│  ██║    ██║██╔══██╗╚██╗ ██╔╝╚══██╔══╝██╔═══██╗██╔══██╗██╔════╝ ██║ │
│  ██║ █╗ ██║███████║ ╚████╔╝    ██║   ██║   ██║███████║██║  ███╗██║ │
│  ██║███╗██║██╔══██║  ╚██╔╝     ██║   ██║   ██║██╔══██║██║   ██║██║ │
│  ╚███╔███╔╝██║  ██║   ██║      ██║   ╚██████╔╝██║  ██║╚██████╔╝██║ │
│   ╚══╝╚══╝ ╚═╝  ╚═╝   ╚═╝      ╚═╝    ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝│
│                                                                      │
│  ❯ ✦ AI Community  ·  Empowered by AI  ✦                            │
│  ────────────────────────────────────────────────────────────────── │
│  claude-opus-4.6  ·  Pro  ·  v1.0.0                                 │
│  ~/your-project                                                      │
│  💡  Tip: Use /help to see all available commands                   │
│                                                                      │
╰──────────────────────────────────────────────────────────────────────╯

Installation

From GitHub (Recommended)

npm install -g github:AAAAAAAJ/WaytoAGI-CLI

From source

git clone https://github.com/AAAAAAAJ/WaytoAGI-CLI.git
cd WaytoAGI-CLI
npm install
npm link

Requires Node.js 18+

Quick Start

# Navigate to your project
cd your-project

# Start WaytoAGI CLI
waytoagi

# Or start with a task
waytoagi "explain this codebase to me"

Usage

Interactive Mode

waytoagi

Launch the CLI in interactive mode. Ask questions, give instructions, or let it explore your codebase.

One-shot Mode

waytoagi "fix the failing tests in src/utils"
waytoagi "add dark mode support to the settings page"
waytoagi "refactor the auth middleware to use JWT"

Pipe Mode

cat error.log | waytoagi "explain these errors and suggest fixes"
git diff | waytoagi "review this change"

Features

Feature	Description
Code Generation	Write new features, components, and modules from natural language
Bug Fixing	Describe the bug, let the CLI find and fix it
Code Review	Get instant feedback on your changes
Refactoring	Restructure code while preserving behavior
Testing	Generate and run tests automatically
Git Operations	Commit, create PRs, manage branches
Multi-file Editing	Edit multiple files in a single operation
Terminal Commands	Run shell commands with safety guardrails
MCP Servers	Extend capabilities with Model Context Protocol
Agent Mode	Autonomous multi-step task execution

Slash Commands

Command	Description
`/help`	Show available commands
`/compact`	Compact conversation history
`/clear`	Clear conversation
`/model`	Switch AI model
`/cost`	Show token usage and cost
`/commit`	Auto-generate a commit message
`/review`	Review code changes
`/pr`	Create a pull request
`/init`	Initialize project configuration

Configuration

WAYTOAGI.md

Create a WAYTOAGI.md file in your project root to provide project-specific context:

# Project Context

- This is a Next.js 14 app with TypeScript
- Use pnpm for package management
- Follow the existing code style
- Tests are in __tests__ directories

Settings

# Global settings
~/.waytoagi/settings.json

# Project settings
.waytoagi/settings.json

Keyboard Shortcuts

Shortcut	Action
`Enter`	Send message
`Esc`	Cancel current operation
`Ctrl+C`	Exit
`Ctrl+L`	Clear screen
`Tab`	Autocomplete
`↑` / `↓`	Navigate history

Security

All file operations require explicit approval or configured permissions
API keys are stored securely in the system keychain
No code is sent to third parties beyond the AI provider
Sandbox mode available for restricted environments

Requirements

Node.js 18 or later
OS: macOS, Linux, or Windows (via WSL)
API Key: WaytoAGI API key or Pro/Max subscription

Community

Website: waytoagi.com
Issues: GitHub Issues

License

MIT

Extension points exported contracts — how you extend this code

IParsedCommand (Interface)

(no doc) [4 implementers]

utils/bash/ParsedCommand.ts

IDEPathConverter (Interface)

(no doc) [2 implementers]

utils/idePathConversion.ts

SkillFrontmatter (Interface)

Individual skill detail for context display

utils/analyzeContext.ts

FormattedMessages (Interface)

* Result of formatting messages - separates regular content from system reminders.

utils/telemetry/betaSessionTracing.ts

Props (Interface)

(no doc)

components/ContextVisualization.tsx

TeleportResumeWrapperProps (Interface)

(no doc)

components/TeleportResumeWrapper.tsx

Props (Interface)

(no doc)

components/SentryErrorBoundary.ts

InvalidConfigHandlerProps (Interface)

(no doc)

components/InvalidConfigDialog.tsx

Core symbols most depended-on inside this repo

services/analytics/index.ts

has

called by 699

utils/fileStateCache.ts

utils/fileStateCache.ts

max

called by 438

utils/fileStateCache.ts

utils/slowOperations.ts

Shape

Function 10,433

Method 1,031

Class 256

Interface 83

Enum 1

Languages

TypeScript100%

Modules by API surface

bootstrap/state.ts212 symbols

utils/sessionStorage.ts156 symbols

native-ts/yoga-layout/index.ts144 symbols

utils/messages.ts122 symbols

utils/Cursor.ts105 symbols

utils/bash/bashParser.ts84 symbols

utils/attachments.ts74 symbols

utils/auth.ts69 symbols

utils/hooks.ts67 symbols

services/mcp/client.ts67 symbols

utils/sandbox/sandbox-adapter.ts59 symbols

ink/ink.tsx54 symbols

For agents

$ claude mcp add WaytoAGI-CLI \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact