2026/07/22 2:12

Show HN: CodeAlmanac – あなたの対話から生成される Karpathy スタイルのコードベースウィキ

RSS: https://news.ycombinator.com/rss

要約▶

Japanese Translation:

CodeAlmanac は、クラウドへのログインやデータアップロードを必要とせずに、システム履歴、破損したコンポーネント、およびクロスファイルのワークフローについて深い洞察を提供する専用エージェントによって管理される、ローカルコードベースのための AI 搭載型ライビングウィキとして機能します。macOS 向けに設計されており、Codex または Claude Code と連携し動作します。Python 3.12 以上が必要であり、インストールコマンドは

uv tool install codealmanac@latest

です（従来の npm パッケージは廃止済み）。プライバシーを最優先とし、ユーザーが匿名テレメトリーを完全に無効化できるため、コード、パス、認証情報などは外部へ送信されません。ただし、

ingest

、

garden

、

build

などのコマンドを実行する信頼されたローカルエージェントは、

almanac/

ディレクトリで定義されたポリシー境界内における広範なファイルシステム権限を持って動作することに注意してください。セットアップは

codealmanac init

コマンドによる構造化初期化から始まり、その後、データを最新状態に保つために 3 つの自動化されたバックグラウンドジョブが実行されます：5 時間ごとの同期（Sync）、そして毎日実行される Garden と Update です。これらは CLI を介して手動でもトリガー可能です。アプリケーションはセキュリティを強化するため、ランタイム状態を Git の履歴から除外される独立したディレクトリ（

~/.codealmac/

）に保存し、ウィキコンテンツはリポジトリ内の

almanac/

フォルダ下に配置します。ユーザーは

~/.codealmanac/config.toml

で設定を構成でき、略称「ca」を使用できます。また、特定のフラグを用いたり再インストールしたりすることで、ランナーやハーネスエラー（例：ENOENT）を切り替えたりトラブルシューティングしたりできます。最終的に、依存関係とシステム状態を即座に可視化する包括的なローカル Web ビューア（

codealmanac serve

）を提供し、Git の差分、GitHub の PR/Issues、URL、エージェントのトランスクリプトなど多様な入力をインGEST することが可能です。

本文

CodeAlmanac リビング・ウィキガイド

CodeAlmanac は AI コーディングエージェントによって維持・管理されるリビング・ウィキです。システムの状態、以前に壊れた部分、重要不変条件、ワークフローのサービス間横断といった、コードには保持できないコンテキストを AI エージェントへ提供します。

リポジトリ内のプレーンな Markdown ファイルで構成され、ローカライズされたインデックスを持ち、Git でレビュー可能です。

環境要件

プラットフォーム: macOS (Codex または Claude Code 使用)
Python バージョン: Python 3.12 以上が必要です

クイックスタート

# インストールと設定
uv tool install codealmanac@latest
codealmanac setup

詳細な設定オプションについては設定 (Setup) を参照してください。

基本的なコマンド

cd your-repo

# ウィキが存在しない場合に作成する
codealmanac init 

# 検索してウィキページを表示する
codealmanac search "getting started"

# ターミナルで単一のページを開く
codealmanac show getting-started

# ローカルの Web ビューア上でウィキを表示する
codealmanac serve

設定 (Setup)

使用するローカルツール向けのグローバルなエージェント指示書（インストラクション）をインストールします。

インストールオプション

以下のコマンドのいずれかを実行してください：

インタラクティブな設定:
```
codealmanac setup
```

推奨デフォルト値での高速インストール (Codex):

codealmanac setup --yes

Claude を AI ランナーとして使用する高速インストール:

codealmanac setup --yes --runner claude

インストールされるバックグラウンドジョブ

以下の 3 つの

launchd

ジョブ（タスク）がローカルで実行されます。

ジョブ	デフォルトスケジュール	役割
Sync	5 時間ごと	最新の Codex および Claude の対話をスキャンし、ウィキに有用な知識を登録します。
Garden	24 時間ごと	陳腐化や重複を検出し、ウィキグラフを改善・レビューします。
Update	24 時間ごと	安全なタイミングで CodeAlmanac CLI を更新します。

自動化状態の確認は

codealmanac automation status

で可能です。

テレメトリ（遥測）について

設定時に匿名テレメトリの導入を問われます。**「Yes」**を選ぶことを推奨します。

送信されるのはコマンドの実行結果、ライフサイクルの状態、およびサンタイズされたクラッシュ情報のみです。
コード、パス、引数、クエリ、プロンプト、スクリプト、認証情報は絶対に送信されません。

テレメトリの無効化

以下のいずれかを実行することでテレメトリを無効にできます：

設定画面で「No」を選択する
コマンドに
```
--no-telemetry
```
を指定する
```
telemetry.enabled = false
```
を設定ファイルに記述する
環境変数
```
DO_NOT_TRACK=1
```
を設定する

注意:
--target
オプションは、インストールするエージェント指示書ファイル（Codex か Claude）のみを選択します。実行環境自体を変更しない点にご注意ください。
codealmanac setup --yes --target codex
# または
codealmanac setup --yes --target claude

自動処理のカスタマイズ

# スキャン間隔の変更（例：5 時間ごと）
codealmanac setup --yes --sync-every 5h

# 自動対話転記（シンク）のインストールをスキップ
codealmanac setup --yes --sync-off

# 自動ウィキクリーンアップ（ガーデニング）のインストールをスキップ
codealmanac setup --yes --garden-off

# 自動アップデートのインストールをスキップ
codealmanac setup --yes --no-auto-update

アンインストール

ローカルアーティファクトを完全に削除するには：

codealmanac uninstall --yes

日常使用 (Daily Read Surface)

エージェントと人間は同一のローカルコマンドを使用します。

# 検索
codealmanac search "checkout timeout"
codealmanac search --mentions src/checkout/

# 表示とトピック
codealmanac show checkout-flow
codealmanac topics
codealmanac health
codealmanac validate

別のローカルウィキを読み込むには

--wiki <name>

オプションを使用します。デフォルトは現在ディレクトリをターゲットにします。

ウィキの更新 (Updating The Wiki)

ライフサイクルコマンドは、Yoke SDK を介して明示的なエージェント（ビルド、インゲスト、ガーデン）を起動します。

ingest: 選択された素材（ファイル、Git の差分、PR/Issue、URL など）をウィキに統合します。
garden: 既存のウィキグラフ（陳腐化ページ、弱いリンクなど）の改善を行います。

信頼モデル: ライフサイクルコマンドは OS サンドボックスではなく、「指示およびコミットポリシー」によって保護されたローカルコーディングエージェントとして機能します。自動コミットが無効な場合は、生成された Git の差分を必ずレビューしてください。

# 例：README のインGEST
codealmanac ingest README.md --using codex

# 例：GitHub PR のインGEST
codealmanac ingest github:pr:123 --using claude

# 例：ガーデニング実行
codealmanac garden --using codex

進捗の監視

init

ingest

garden

はキューイングされた実行を開始します。

Web ビューアでの追跡:

codealmanac serve
# サイドバーの「Jobs」タブを選択して監視

ターミナルでの追跡:

codealmanac jobs attach <run-id>

シンクと自動化 (Sync And Automation)

ホステドサービスではなく、ローカルの

launchd

ジョブによって管理されます。

Sync: 完了した対話をスキャンし、関連ジョブにキューイングします。知識がない対話はウィキを更新しません。
Garden: 定期的なメンテナンスを自動実行します。
Update: ローカル CLI のバージョン更新を管理します（安全でないタイミングではスキップされます）。

スケジュールの管理

# インストール済みスケジュールの確認
codealmanac automation status

# スケジュールの変更 (TOML 設定への反映)
codealmanac config set automation.sync.every 5h
codealmanac config set automation.garden.every 24h
codealmanac config set automation.update.every 24h

# 有効/無効の切り替え
codealmanac config set automation.sync.enabled false

設定変更後、ファイルの編集場合は

codealmanac config apply

を実行してください。

ジョブ (Jobs)

ライフサイクル実行は

~/.codealmanac/

下に記録され、以下のコマンドで制御できます。

コマンド	説明
`codealmanac jobs`	ID、ステータス、経過時間の最近のジョブを一覧表示します。
`codealmanac jobs show <run-id>`	詳細なサマリー（エラー、タイムスタンプなど）を表示します。
`codealmanac jobs logs <run-id>`	イベント履歴のスナップショットを出力します。
`codealmanac jobs attach <run-id>`	ライブ監視を開始し、イベントが到着するまで続けます。
`codealmanac jobs cancel <run-id>`	実行中のジョブを終了させます。

スクリプトからの出力には
--json
フラグを追加してください。ターミナルが閉じても永続的なローカルコードにより動作を継続できます。

プロバイダー (Providers)

CodeAlmanac は

almanac-yoke

を境界として使用します。

Codex: アプリサーバー経由で実行（OAuth セッションの再利用）。
Claude: Yoke のデフォルトサーフェース（Python Agent SDK）を使用。

# 認証の確認と準備
codex login
claude auth login
codealmanac doctor

読み込みコマンドは認証情報不要ですが、書き込みコマンドにはハルネスの認証が必要です。

エージェント構成は

src/codealmanac/agents/

下にあり、Yoke のネイティブ契約に従っています（

agent.yaml

instructions.md

）。

Init で生成される構造

デフォルトルートでは以下のディレクトリが作成されます：

your-repo/
|-- almanac/              # ウィキの根元
|   |-- README.md         # ランディングページ
|   |-- topics.yaml       # ファイル間の整理
|   |-- architecture/     # アーキテクチャ情報
|   |   |-- indexer.md    # インデックス定義
|   |-- decisions/        # 意思決定記録
|   |   `-- local-first.md
|   `-- guides/           # ガイダンス
|       `-- setup.md
|-- src/                  # ソースコード
`-- ...                   # 他のファイル

CodeAlmanac ウィキとして認識される条件は、

almanac/topics.yaml

と

almanac/README.md

の存在です。

ランタイムステート (Runtime State)

ローカルデータは

~/.codealmanac/

下に保存されます：

Global:
```
~/.codealmanac/codealmanac.db
```
Per-Repo:
```
~/.codealmanac/repos/<repo-id>/index.db
```

これらのデータベースはリポジトリ、イベント、ロック状態などを記録しますが、コミットされる

almanac/

フォルダには含まれません。

設定 (Configuration)

ユーザー設定は

~/.codealmanac/config.toml

にあります。

# デフォルト値
auto_commit = true

[harness]
default = "codex"
model = "gpt-5.5"

[automation.sync]
enabled = true
every = "5h"

[automation.garden]
enabled = true
every = "24h"

[automation.update]
enabled = true
every = "24h"

CLI からの設定変更

通常は以下のコマンドで即座に変更を適用できます：

codealmanac config set <key> <value>

auto_commit

の注意

ライフサイクルエージェントは Git コマンドを使って直接変更を行う可能性があります。CodeAlmanac は自動的にステージングやコミットを行いません。

手動で管理したい場合は、設定を変更する必要があります：

codealmanac config set auto_commit false

ローカルビューア (Local Viewer)

モード: 読み取り専用。ページ、検索結果、トピック、バックリンクを表示します。
自動起動:
```
serve
```
コマンドはサーバー起動時にブラウザを自動的に開きます。

ヘッドレス/スクリプト用途:

codealmanac serve --no-open

特定のウィキに絞り込むには：

codealmanac serve --wiki <name>

npm CLI から移行 (Migrating From The npm CLI)

レガシーな

codealmanac

npm パッケージは廃止されました。PyPI でのみサポートされています。古いインストールが残留している場合は以下の手順でクリーンアップしてください。

# 1. npm グローバルパッケージの削除
npm uninstall -g codealmanac

# 2. 新しい Python CLI のインストール
uv tool install codealmanac@latest

# 3. セットアップと確認
codealmanac setup --yes
codealmanac doctor

```
bun
```
,
```
pnpm
```
,
```
yarn
```
や PATH 上のレガシーバイナリも削除してください。
リポジトリ内のコミット済み
```
almanac/
```
フォルダには手を入れず、CLI の設定部分のみを交換します。

トラブルシューティング

エラー:

spawn ... codex ENOENT

Codex CLI にバイナリが存在しないか、バージョン不一致が発生しています（Node バージョンの切り替えなどが原因）。

確認方法:

codex --version
codex login status

解決策:

再インストール:

npm install -g @openai/codex

(注意：ログイン状態は維持されます)

または、ハルネスを切り替え (Claude へ):

codealmanac config set harness.default claude

同様のエラーが発生する場合は

codealmanac doctor

で状態を確認してください。

現在の契約 (Current Contract)

スコープ: ローカル限定（ホステドログイン・アップロード機能なし）。
公開コマンド:
```
codealmanac
```
（短縮:
```
ca
```
）。
リポジトリルート:
```
almanac/
```
のみ。
ユーザーステート:
```
~/.codealmanac/
```
。
ランタイム: Python 3.12+。
ストレージ: ローカル Markdown テキスト + ローカルの派生ステートファイル。
公開 SDK/MCP: なし。
アップロードパスなし: ウィキ、ソースコード、プロンプト、転記などのアップロードは行いません。

ホステド統合は将来的な可能性がありますが、現在のリリーススコープには含まれません。

同じ日のほかのニュース

一覧に戻る →

2026/07/22 6:09

ヤコビアン仮説の反例についての考察

## Japanese Translation: 元要約は明確で正確であり、主要な点と整合性が取られています。改善は必要ありません。 ## 概要：テキストは決定的に、ヤコビアン予想が三次元以上の次元では偽であることを述べており、$\mathbb{C}^n$ から $\mathbb{C}^n$ への写像で非ゼロ定数のヤコビアンを持つものがすべて全的に逆関数を持つというアイデアを反証することで、長年の数学的議論を解決します。研究者たちは、三次変数における次数七の多項式写像を構成することによってこれを証明しました。この写像は非ゼロ定数のヤコビアンを持ちながら全球的反関数を持たず、ヤコビアンの行列における巨大なキャンセル（非定数係数の消滅）に依存して局所的逆関性を維持しつつ全球的な有効性を回避しています。予想は二次元的には依然として未解決であり、一元的には自明に真です。幾何学的な再定式化により、$\mathbb{C}^n$ と同型なアフィン多様体 $X$ に対して、局所的単射（根解析を用いた証明で $\mathrm{PGL}_2$ ヨーブ変換とゼロでない結果ant を用いて確立）だが全球的には単射ではないような写像が存在することが示されます。ベクトル空間の対称化乗幂と低次数多項式の積（線形 × 二次 = 三次）に基づく構築では、五次元群作用による巨大な等変性を活用し、結果ant 条件を用いたスケーリング対称性を通じて正規化を行います。特定の三次元的アフィン切片による次元削減は、二次曲面の同型問題を回避しつつ主要な性質を保持し、原点ファイバーを除いて座標に対して三次方程式と二次方程式を解くことで双有理同値を可能にし、アフィン空間と同型のアフィン多様体を導きます。ビッグ-O 記法を用いた漸近解析は、全てのファイバー（極限ケースを含む）をカバーする全球的多項式パラメータ化を確認します。AI チャットボットを含む高度な計算ツールは、漸近成長率とファイバーパラメータ化に関わる複雑な計算を検証し、得られた写像是自明な変数変化を除いて元の反例と一致します。この画期的な進展により、分野の焦点は普遍的反證法の探求から、局所的性質が全球的な振る舞いを保証しない特定の実例への理解へとシフトしました。

2026/07/22 0:17

Gemini 3.6 Flash、3.5 Flash-Lite および 3.5 Flash Cyber

## Japanese 翻訳: 以下の改良版は、欠落していた価格データ、具体的なベンチマークハイライト、および販売チャネルを統合し、「要点リスト」への完全な忠実性を確保しています： ## 改善されたサマリー Google は正式に、AI エージェントの効率を大幅に向上させ、レイテンシを低減し、コストを削減することを目的とした 3 つの進化した Gemini モデル——3.6 Flash、3.5 Flash-Lite、および専門性の高い 3.5 Flash Cyber を紹介しました。**Gemini 3.6 Flash**は、トークン使用量を最大で 17%削減（入力トークンあたり$1.50 で提供）しながら、より高い精度を実現します。DeepSWE のようなベンチマークでは、先行する 3.5 Flash の 37% に対して 49% という成功率を達成し、ML リサーチおよびコンピューター使用に関する能力にも顕著な改善が見られます。**Gemini 3.5 Flash-Lite**はシリーズ内で最も高速なモデルとして際立っており、1 秒間に 350 以上の出力トークンを処理（入力トークンあたり$0.3 で提供）し、複数のコーディングベンチマークにおいて 3.5 Flash および 3 Flash を凌駕しています。セキュリティニーズに応えるため、Google は CodeMender エコシステム内でのサイバーセキュリティ脆弱性の特定と是正に最適化された**3.5 Flash Cyber**バリアントをローンチしました。これらの技術の二重用途特性により、この特定のモデルは、限定されたパイロットプログラムを通じて検証済みの政府機関および信頼パートナーのみが利用可能です。すべての新モデルは直ちに Gemini API、Google AI Studio、Android Studio、およびその他の開発プラットフォーム経由で利用可能であり、すぐに Google Search への展開も始まっています。

2026/07/22 0:41

長らく死んだとみられていた西アフリカに、豊かなサンゴ礁が発見された。

## Japanese 翻訳: 1960 年代の初期調査で西アフリカベニン海岸沖の健康なサンゴ礁が存在しないと見落されていたものが、研究者によってついにその存在が確認され、世界中で半分以上の礁域が減少しているというグローバルなトレンドに抗した。水深 175 フィート（約 53 メートル）を超える深い海域においても、岩盤基質上に多様な生物が生息し、繁栄している。2025 年 1 月に National Geographic Explorers グランツから 2 万ドルの助成金を獲得した Gérard Zinzindohoué 氏を率いるチームは、高価なソナー費用が予算の大半を食い込み、欧州のサプライヤーとの銀行取引上の問題といった重大な物流上の課題を克服した。常設の研究船を持たないため、彼らはハイテクソナーを搭載したピロウで現地漁師に offshore へ運ばれ、海底を探測して撮影を行った。この探査では、軟体珊瑚 6 タイプ、黒珊瑚 2 タイプ、魚類 8 種を特定し、該地域を「中光層サンゴ生態系（mesophotic coral ecosystem）」に分類した——これはサンゴ礁形成の限界深度にある光依存型コミュニティである。地元研究者である Houangninan Midinoudewa 氏は、現在、稀有种類であるトゲメダイアザルシャーク、シルクイースカ、ブローンスケート、マーズレットエイを含む稀有な種々を守るため、「重要なエイとサメ地域（Important Shark and Ray Area）」としての指定を求めている。保存活動だけでなく、この未撹乱の生態系は、炭素年代測定や古気候学研究における独自の潜在力を提供し、広範な劣化に反して回復力ある天然資源を開示するとともに、科学発掘への新たな道を開く。