はじめに
AIコーディングツール（Cursor、GitHub Copilot、Windsurfなど）は便利ですが、月額料金がかかるのが悩みどころです。
そこで作ったのが Codeably です。
💰 利用料金$0 — 自分のAPIキーを使うだけ
🖥️ ターミナルで動く — IDEは不要
🔧 30種類のツール搭載
🌐 7つのプロバイダー対応（無料枠あり）
インストール
bash# グローバルインストール（推奨）
npm install -g codeably
インストールなしで今すぐ試す
npx codeably "やりたいタスク"
Node.js 18以上が必要です。
基本的な使い方
bash# タスクを直接渡す
codeably "ログインフォームにバリデーションを追加して"
codeably "src/utils.js のテストを書いて"
codeably "auth.js をリファクタリングして小さな関数に分割して"
組み込みコマンド
codeably clean # デッドコードを検出・削除
codeably review # 最近のgit変更をAIがコードレビュー
codeably docs # プロジェクトのドキュメントを自動生成
codeably init # 新しいプロジェクトをスキャフォールド
設定・情報
codeably config # プロバイダーやAPIキーを変更
codeably whoami # 現在のプロバイダーとモデルを確認
codeably history # 最近のセッション履歴
ショートカット設定（cbコマンド）
毎回 codeably と打つのが面倒な方向けに、cb という短縮コマンドを設定できます。
macOS / Linux / WSL:
bashbash install-shortcut.sh
source ~/.zshrc
Windows（PowerShell）:
powershell.\install-shortcut.ps1
. $PROFILE
設定後：
bashcb "auth.jsをリファクタリングして"
cb clean
cb review
対応プロバイダー（7種類）
自分のAPIキーを使うので、コストはプロバイダーの料金のみです。
無料枠だけで十分使えます。
プロバイダーモデル無料枠取得先GroqLlama 3.3 70B1日14,400リクエストconsole.groq.comGeminiGemini 2.0 Flash1日1,500リクエストaistudio.google.comOllamaCodeLlama等完全無料（ローカル）ollama.comOpenRouter100+モデル無料モデルありopenrouter.aiAnthropicClaude Sonnet 4サインアップで$5console.anthropic.comMistralMistral Large無料トライアルconsole.mistral.aiOpenAIGPT-4o従量課金platform.openai.com
初回セットアップ
codeably と打つと、最初の1回だけセットアップウィザードが起動します：
╭─────────────────────────────────────────────────────╮
│ >/< codeably │
│ autonomous coding agent for your terminal │
│ 7 providers 30 tools free forever │
╰─────────────────────────────────────────────────────╯
Choose a provider:
- Anthropic (Claude Sonnet 4) Free $5 credit on signup
- OpenAI (GPT-4o) Pay per use
- Groq (Llama 3.3 70B) FREE — 14,400 requests/day
- Google (Gemini 2.0 Flash) FREE — 1,500 requests/day
- Mistral (Mistral Large) Free trial credits
- OpenRouter (100+ models) FREE models available
- Ollama (local, offline) FREE forever
your choice (1-7): _
設定は ~/.codeably/config.json に保存されます。キーは絶対に外部に送信されません。
動作の仕組み
すべてのタスクは同じループで処理されます：
観察（OBSERVE） → ファイル一覧・言語検出・関連コード読み込み
思考（THINK） → 何を・どの順序でやるか決定
実行（ACT） → ファイル書き込み・編集・削除・コマンド実行
検証（VERIFY） → テスト・ビルドで動作確認
完了（DONE） → 変更内容を一行で報告
完了するかステップ上限（デフォルト50）に達するまで自動でループします。
30種類のツール一覧
ファイル操作
ツール説明read_fileファイルを読む（行範囲指定可）write_fileファイルを作成・上書きpatch_fileファイル内の文字列を安全に置換append_fileファイル末尾に追記insert_lines指定行にコンテンツを挿入delete_lines指定行範囲を削除copy_fileファイルをコピーmove_fileファイルを移動・リネームdelete_fileファイルを削除（確認必須）delete_files_bulk複数ファイルを一括削除（確認必須）
ディレクトリ・検索
ツール説明make_dirディレクトリを作成list_filesディレクトリツリーを探索list_dirファイルサイズ付き一覧search_code全ファイルでパターン検索find_filesglobパターンでファイル検索grep_replace複数ファイルで一括置換
シェル・Git
ツール説明run_commandシェルコマンドを実行run_script複数行bashスクリプトを実行git_status変更ファイルを表示git_diff差分を表示git_logコミット履歴を表示git_commit全変更をコミット
安全・制御
ツール説明confirm_delete削除前にユーザー確認（強制）doneタスク完了を通知
安全性について
Codeablyはファイルを削除する前に必ず確認を求めます：
⚠ 削除の確認が必要です
理由: 未使用ファイル、importがゼロ
削除するファイル:
- src/old-utils.js
- src/deprecated/auth.js
これらの2ファイルを削除しますか？ [y/N]:
y で実行、それ以外でキャンセル。
明示的な承認なしにファイルを削除することはできません。
実用的な使用例
bash# 機能追加
codeably "ExpressアプリにJWT認証を追加して"
codeably "レート制限を追加 — IPごとに毎分100リクエスト"
codeably "全APIエンドポイントにバリデーションを追加して"
コード整理
codeably clean
codeably "src/の全console.logを削除して"
codeably "api.jsのコールバックをasync/awaitに移行して"
テスト作成
codeably "utils.jsの全エクスポート関数のユニットテストを書いて"
codeably "認証ルートの統合テストを追加して"
リファクタリング
codeably "300行のUserControllerを小さなファイルに分割して"
codeably "ハードコードされた文字列を定数ファイルに抽出して"
バグ修正
codeably "メールが空のときログインフォームがクラッシュする — 修正して"
レビュー・ドキュメント
codeably review
codeably docs
アーキテクチャ
フレームワークなし、LangChainなし。約900行のシンプルな設計です。
codeably/
├── codeably.js ← CLIエントリポイント
├── install-shortcut.sh ← Mac/Linux ショートカット設定
├── install-shortcut.ps1 ← Windows ショートカット設定
├── config/
│ ├── providers.js ← プロバイダー定義
│ ├── store.js ← 設定の読み書き
│ └── setup.js ← 初回セットアップウィザード
├── runtime/
│ ├── agent.js ← Observe-Think-Actループ
│ ├── client.js ← 統合LLMクライアント
│ ├── context.js ← コードベーススナップショット
│ └── memory.js ← セッション履歴
├── tools/
│ └── index.js ← 30ツール定義
├── ui/
│ └── renderer.js ← ターミナルUI
└── docs/
├── README.ja.md ← 日本語ドキュメント
├── README.zh.md ← 中文ドキュメント
└── README.ko.md ← 한국어ドキュメント
テスト実行
bashnpm test
30ツール全体に対して25項目のチェックを実行。APIキー不要。
まとめ
項目内容料金$0（自分のキーを使用）対応OSMac / Linux / Windows対応プロバイダー7種類（無料枠あり）ツール数30種類コード量約900行依存関係openai パッケージのみ
GitHubはこちら 👉 https://github.com/adamyasingh-05/Codeably
フィードバック・Issue・Star お待ちしています！⭐
built with ❤ — 自分のキーで、自分のエージェントを