Quick start
- Activate the project virtualenv (expected at
.venv):source .venv/bin/activate
- Install the package (PyPI想定) or editable mode:
# PyPI (予定) pip install context-delta-proto # またはローカルeditable pip install -e .
- Create or point to a
.envwith model/provider config, then run the CLI:delta --help delta "READMEを要約して" # チャット(デフォルトはフルオート) delta --manual "READMEを要約して" # 承認付きチャット delta read_file --file "$(pwd)/some.txt" --offset 1 --limit 10 --indent delta list_dir --dir "$(pwd)" --offset 1 --limit 20 --depth 2 delta --plan-file plan.json "planに従って進めて" # Planを注入してチャットを開始
Chat mode defaults to auto-approval (Codex風フルオート)。承認を入れたいときは --manual を付けるか、各ツールサブコマンドで --yes を外して実行してください。
Plan駆動で進める場合:
delta --plan-file plan.json "planに従って進めて"でplanを注入。--max-stepsで完了ステップ数を制限できる。- plan更新時は
update_planに{"plan":[...全ステップ...]}をそのまま渡す。apply_patchは*** Begin Patch/*** End Patch形式で与える。
.env / 環境変数の例
# モデル/プロバイダ
MODEL=openai/gpt-oss-20b # gpt-5* なら OpenAI、その他は LMStudio/Ollama を自動判定
OPENAI_API_KEY=sk-... # OpenAIを使う場合
LMSTUDIO_BASE_URL=http://localhost:1234
OLLAMA_BASE_URL=http://localhost:11434
# Web検索
SEARCH_PROVIDER=tavily # 例: tavily / mock
SEARCH_API_KEY=tvly-dev-...
.env は起動時に読み込まれ、環境変数より優先されます。
よく使うサブコマンド
delta "prompt": チャット(フルオート)。--manualで承認付き。--max-turnsでターン制限。delta read_file --file <abs> --offset 1 --limit 20 --indent: 行番号なしで抜粋。delta list_dir --dir <abs> --depth 2 --limit 20: ツリー表示(.git/ignoreはデフォルト除外)。delta shell_command --workdir <abs> "cmd": シェルコマンド(確認付き、--yesでスキップ)。delta exec ...: 非対話のローカル実行。delta --plan-file plan.json "planに従って進めて": planを注入してステップ実行。
apply_patchのフォーマット(重要)
ファイル作成/編集は必ず *** Begin Patch ... *** End Patch 形式を使用し、Add/Update ブロックの中に先頭+付きで内容を書くこと。
update_planの呼び出し
常に全ステップを含む JSON({"plan":[...全ステップ...]})を渡してください。ステップ内容が曖昧な場合は、実行前に質問してから進めるように誘導すると安定します。
Metadata
Release files for context-delta-proto 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| context_delta_proto-0.0.1.tar.gz | 20.8 kB | Without provenance | Details for context_delta_proto-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| context_delta_proto-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for context_delta_proto-0.0.1-py3-none-any.whl |
Total release size: 41.6 kB
Release files / context_delta_proto-0.0.1.tar.gz
| Download URL | context_delta_proto-0.0.1.tar.gz |
|---|---|
| Size | 20.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
24d2d79d2edd17e7c75b1fa99e34cdd1496fda2a7817b1742cfbfc8c5a9649db
|
|
BLAKE2b-256 checksum How to use checksums |
373af89edccffec640ecb4c828f74a648b751966824f2eec89f936f9989f1a17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.13
|
Release files / context_delta_proto-0.0.1-py3-none-any.whl
| Download URL | context_delta_proto-0.0.1-py3-none-any.whl |
|---|---|
| Size | 20.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
705cbd4771074584339294fd1f681e65bafbdd4c0ca9e3df894dda8f7c13c778
|
|
BLAKE2b-256 checksum How to use checksums |
402f1d2f7968232eb602065632a66fa7cd2742aa54db411be284175da786d515
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.13
|
Security for context-delta-proto 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.