AKB — Agent Knowledge Base
Memory serverOfficial Dnotitia project
Created by Dnotitia
Published in dnotitia/akb. Publisher page
167 GitHub stars
What it is
AKB — Agent Knowledgebase. Organizational memory for AI agents: vault-scoped docs / tables / files unified by URI graph, served over MCP.
Summary from the brain’s metadata
AKB — Agent Knowledgebase. Organizational memory for AI agents: vault-scoped docs / tables / files unified by URI graph, served over MCP.
How it works
Memory model: Hybrid
AutoGineer overview, from the brain’s own files
Memory model: Hybrid. Folders: .claude (agent config, 4 files); .codex (agent config, 4 files); .github (agent config, 4 files); agents (agent instructions, 2 files); docs (docs, 188 files); packages (source code, 74 files); scripts (scripts, 24 files); templates (templates, 20 files). The agent reads AGENTS.md, frontend/DESIGN_SYSTEM.md.
| Folder | Role | Files |
|---|---|---|
| .claude | agent-config | 4 |
| .codex | agent-config | 4 |
| .github | agent-config | 4 |
| agents | agent-instructions | 2 |
| docs | docs | 188 |
| packages | source-code | 74 |
| scripts | scripts | 24 |
| templates | templates | 20 |
| .agents | folder | 2 |
| .claude-plugin | folder | 1 |
| backend | folder | 1080 |
| config | folder | 2 |
| deploy | folder | 65 |
| eval | folder | 89 |
| frontend | folder | 703 |
| okf | folder | 6 |
| plugins | folder | 44 |
The agent reads
- AGENTS.md evidence: AGENTS.md
- frontend/DESIGN_SYSTEM.md evidence: AGENTS.md
Requirements
Apps: Docker
Databases: PostgreSQL, Qdrant, Redis
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Google Antigravity, Kiro, OpenCode, Amp, Roo Code, Cline, JetBrains Junie, Devin (ex-Windsurf)
Set it up
This brain runs code automatically: 4 hooks (claude-code). Review plugins/claude/akb-claude-code/hooks/hooks.json before opening the folder in Claude Code. No step below turns a hook on for you.
plugins/claude/akb-claude-code/hooks/hooks.json:"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"plugins/claude/akb-claude-code/hooks/hooks.json:"${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit.sh"plugins/claude/akb-claude-code/hooks/hooks.json:"${CLAUDE_PLUGIN_ROOT}/hooks/pre-compact.sh"plugins/claude/akb-claude-code/hooks/hooks.json:"${CLAUDE_PLUGIN_ROOT}/hooks/session-end.sh"
- Not scanned by AutoGineerThe author’s README also describes installing it with Docker Compose. Read its install section: AutoGineer did not scan that path. https://github.com/dnotitia/akb/blob/230e3eed24eda4c85132f5badf067109a8021da3/README.md#quick-start
- Not scanned by AutoGineerAutoGineer could not scan everything it runs. https://www.npmjs.com/package/akb-mcp
Created by Dnotitia. Published in dnotitia/akb. Licence: Business Source License 1.1.
Usage
AutoGineer’s guidance for this type of brain
Add the server to your AI tool’s MCP configuration (see Set it up); your agent then stores and recalls memories through its tools.
Documentation by Dnotitia
The licence does not allow AutoGineer to copy these files. Read the documentation at the source
512 files · 512 not served here
- .agents/plugins/marketplace.json (not served here)
- .agents/roles.toml (not served here)
- .claude-plugin/marketplace.json (not served here)
- .claude/agents/explorer.md (not served here)
- .claude/agents/reviewer.md (not served here)
- .claude/agents/worker.md (not served here)
- .claude/settings.json (not served here)
- .codex/agents/explorer.toml (not served here)
- .codex/agents/reviewer.toml (not served here)
- .codex/agents/worker.toml (not served here)
- .codex/config.toml (not served here)
- .dockerignore (not served here)
- .gitattributes (not served here)
- .github/workflows/backend-pytest.yml (not served here)
- .github/workflows/check.yml (not served here)
- .github/workflows/e2e.yml (not served here)
- .github/workflows/images.yml (not served here)
- .gitignore (not served here)
- .nvmrc (not served here)
- .secrets.baseline (not served here)
- AGENTS.md (not served here)
- CONTRIBUTING.md (not served here)
- LICENSE (not served here)
- LICENSE-CHANGE.md (not served here)
- README.md (not served here)
- SECURITY.md (not served here)
- TRADEMARKS.md (not served here)
- agents/requirements.txt (not served here)
- agents/runtime.py (not served here)
- backend/.dockerignore (not served here)
- backend/CHANGELOG.md (not served here)
- backend/Dockerfile (not served here)
- backend/app/__init__.py (not served here)
- backend/app/__main__.py (not served here)
- backend/app/api/__init__.py (not served here)
- backend/app/api/bounded_body.py (not served here)
- backend/app/api/control_plane_models.py (not served here)
- backend/app/api/deps.py (not served here)
- backend/app/api/file_write_context.py (not served here)
- backend/app/api/routes/__init__.py (not served here)
- backend/app/api/routes/access.py (not served here)
- backend/app/api/routes/activity.py (not served here)
- backend/app/api/routes/admin_auth.py (not served here)
- backend/app/api/routes/admin_sso.py (not served here)
- backend/app/api/routes/admin_sso_operation_requests.py (not served here)
- backend/app/api/routes/admin_sso_operations.py (not served here)
- backend/app/api/routes/agent_sessions.py (not served here)
- backend/app/api/routes/app_identity.py (not served here)
- backend/app/api/routes/app_installations.py (not served here)
- backend/app/api/routes/app_inventory.py (not served here)
- backend/app/api/routes/app_legacy_adoptions.py (not served here)
- backend/app/api/routes/app_registry.py (not served here)
- backend/app/api/routes/app_rollouts.py (not served here)
- backend/app/api/routes/assets.py (not served here)
- backend/app/api/routes/auth.py (not served here)
- backend/app/api/routes/collections.py (not served here)
- backend/app/api/routes/documents.py (not served here)
- backend/app/api/routes/events.py (not served here)
- backend/app/api/routes/files.py (not served here)
- backend/app/api/routes/help.py (not served here)
- backend/app/api/routes/knowledge.py (not served here)
- backend/app/api/routes/knowledge_io.py (not served here)
- backend/app/api/routes/notifications.py (not served here)
- backend/app/api/routes/oauth_metadata.py (not served here)
- backend/app/api/routes/public.py (not served here)
- backend/app/api/routes/publication_directory.py (not served here)
- backend/app/api/routes/search.py (not served here)
- backend/app/api/routes/tables.py (not served here)
- backend/app/api/routes/user_avatar.py (not served here)
- backend/app/cli.py (not served here)
- backend/app/config.py (not served here)
- backend/app/db/__init__.py (not served here)
- backend/app/db/init.sql (not served here)
- backend/app/db/migrations/001_relations_to_edges.py (not served here)
- backend/app/db/migrations/002_public_shares.py (not served here)
- backend/app/db/migrations/003_rename_public_shares.py (not served here)
- backend/app/db/migrations/004_embed_retry_columns.py (not served here)
- backend/app/db/migrations/005_qdrant_index.py (not served here)
- backend/app/db/migrations/006_indexable_chunks.py (not served here)
- backend/app/db/migrations/007_outbox_sweep_index.py (not served here)
- backend/app/db/migrations/008_drop_legacy_document_id.py (not served here)
- backend/app/db/migrations/009_rename_qdrant_columns.py (not served here)
- backend/app/db/migrations/010_external_git_mirror.py (not served here)
- backend/app/db/migrations/011_external_doc_collections.py (not served here)
- backend/app/db/migrations/012_drop_llm_metadata_cache.py (not served here)
- backend/app/db/migrations/013_nfc_normalize.py (not served here)
- backend/app/db/migrations/014_chunks_vault_id.py (not served here)
- backend/app/db/migrations/015_events_outbox.py (not served here)
- backend/app/db/migrations/016_chunks_drop_embedding.py (not served here)
- backend/app/db/migrations/017_chunks_indexing_queue_index.py (not served here)
- backend/app/db/migrations/018_drop_redundant_pending_index.py (not served here)
- backend/app/db/migrations/019_s3_delete_outbox.py (not served here)
- backend/app/db/migrations/020_unify_collection_membership.py (not served here)
- backend/app/db/migrations/021_events_resource_uri.py (not served here)
- backend/app/db/migrations/022_publications_resource_uri.py (not served here)
- backend/app/db/migrations/023_drop_metadata_id.py (not served here)
- backend/app/db/migrations/024_tokens_revoked_before.py (not served here)
- backend/app/db/migrations/025_drop_phantom_root_collection.py (not served here)
- backend/app/db/migrations/026_uri_collection_prefix.py (not served here)
- backend/app/db/migrations/027_collection_path_reserved_segments.py (not served here)
- backend/app/db/migrations/028_edges_kind.py (not served here)
- backend/app/db/migrations/029_outbox_chunk_id_index.py (not served here)
- backend/app/db/migrations/030_resource_content_hash.py (not served here)
- backend/app/db/migrations/031_drop_memories_sessions.py (not served here)
- backend/app/db/migrations/032_drop_supersedes.py (not served here)
- backend/app/db/migrations/033_users_auth_provider.py (not served here)
- backend/app/db/migrations/034_oidc_transients.py (not served here)
- backend/app/db/migrations/035_fix_wikilink_alias_edges.py (not served here)
- backend/app/db/migrations/036_resource_aliases.py (not served here)
- backend/app/db/migrations/037_table_unique_keys_indexes.py (not served here)
- backend/app/db/migrations/038_dynamic_table_updated_at_trigger.py (not served here)
- backend/app/db/migrations/039_edges_vault_endpoint_indexes.py (not served here)
- backend/app/db/migrations/040_tokens_vault_scope.py (not served here)
- backend/app/db/migrations/041_tokens_key_class.py (not served here)
- backend/app/db/migrations/042_vault_migrations.py (not served here)
- backend/app/db/migrations/043_workspace_account_governance.py (not served here)
- backend/app/db/migrations/044_vault_write_policy.py (not served here)
- backend/app/db/migrations/045_vault_write_grant_actions.py (not served here)
- backend/app/db/migrations/046_tool_usage.py (not served here)
- backend/app/db/migrations/047_app_registry.py (not served here)
- backend/app/db/migrations/048_native_revision_core.py (not served here)
- backend/app/db/migrations/049_external_git_quarantine.py (not served here)
- backend/app/db/migrations/050_drop_todos.py (not served here)
- backend/app/db/migrations/051_app_credentials.py (not served here)
- backend/app/db/migrations/052_app_inventory.py (not served here)
- backend/app/db/migrations/053_native_revision_m1_pg_body.py (not served here)
- backend/app/db/migrations/054_native_revision_searchable_derived.py (not served here)
- backend/app/db/migrations/055_native_revision_m1_file_storage.py (not served here)
- backend/app/db/migrations/056_native_revision_m1_file_constraints.py (not served here)
- backend/app/db/migrations/057_native_revision_m1_payload_placement.py (not served here)
- backend/app/db/migrations/058_publication_document_identity.py (not served here)
- backend/app/db/migrations/059_native_file_searchable_derived.py (not served here)
- backend/app/db/migrations/060_native_revision_migration_bridge.py (not served here)
- backend/app/db/migrations/061_native_revision_authority.py (not served here)
- backend/app/db/migrations/062_app_rollout.py (not served here)
- backend/app/db/migrations/063_document_image_assets.py (not served here)
- backend/app/db/migrations/064_document_image_asset_lifecycle.py (not served here)
- backend/app/db/migrations/065_document_image_asset_references.py (not served here)
- backend/app/db/migrations/066_document_image_asset_gc_index.py (not served here)
- backend/app/db/migrations/067_vault_file_upload_state.py (not served here)
- backend/app/db/migrations/068_vault_file_lifecycle_indexes.py (not served here)
- backend/app/db/migrations/069_document_asset_revision_lock_order.py (not served here)
- backend/app/db/migrations/070_vault_files_s3_key_lookup.py (not served here)
- backend/app/db/migrations/071_recovery_admin.py (not served here)
- backend/app/db/migrations/072_admin_browser_sessions.py (not served here)
- backend/app/db/migrations/073_app_rollout_resume.py (not served here)
- backend/app/db/migrations/073_sso_bootstrap_receipt.py (not served here)
- backend/app/db/migrations/074_sso_browser_sessions.py (not served here)
- backend/app/db/migrations/075_sso_callback_receipt.py (not served here)
- backend/app/db/migrations/076_sso_session_epoch.py (not served here)
- backend/app/db/migrations/077_legacy_adoptions.py (not served here)
- backend/app/db/migrations/078_recovery_admin_authority_handover.py (not served here)
- backend/app/db/migrations/079_worker_claim_lifecycle.py (not served here)
- backend/app/db/migrations/080_local_forced_credential_change.py (not served here)
- backend/app/db/migrations/081_service_identities.py (not served here)
- backend/app/db/migrations/082_pending_admissions.py (not served here)
- backend/app/db/migrations/083_edge_vault_boundary.py (not served here)
- backend/app/db/migrations/084_bm25_corpus_revision.py (not served here)
- backend/app/db/migrations/085_vault_access_contributions.py (not served here)
- backend/app/db/migrations/086_dynamic_table_rows_changed.py (not served here)
- backend/app/db/migrations/087_tenant_activity_daily.py (not served here)
- backend/app/db/migrations/088_native_revision_existing_cutover.py (not served here)
- backend/app/db/migrations/089_native_file_projection_outbox.py (not served here)
- backend/app/db/migrations/090_native_revision_vault_purge_fence.py (not served here)
- backend/app/db/migrations/091_native_revision_committed_receipt_guard.py (not served here)
- backend/app/db/migrations/092_native_revision_plan_supersession.py (not served here)
- backend/app/db/migrations/093_external_git_retirement.py (not served here)
- backend/app/db/migrations/094_native_revision_completed_reservation_transfer.py (not served here)
- backend/app/db/migrations/095_app_release_manifest_v2.py (not served here)
- backend/app/db/migrations/096_native_revision_cutover_fence.py (not served here)
- backend/app/db/migrations/097_native_revision_migration_inventory.py (not served here)
- backend/app/db/migrations/098_native_revision_nul_payload.py (not served here)
- backend/app/db/migrations/099_personal_notifications.py (not served here)
- backend/app/db/migrations/100_native_revision_cutover_file_applied_path.py (not served here)
- backend/app/db/migrations/101_local_session_generation.py (not served here)
- backend/app/db/migrations/102_account_self_lifecycle.py (not served here)
- backend/app/db/migrations/103_sso_account_lifecycle.py (not served here)
- backend/app/db/migrations/104_file_write_capability_key.py (not served here)
- backend/app/db/migrations/105_bridge_body_digest.py (not served here)
- backend/app/db/migrations/106_native_document_publications.py (not served here)
- backend/app/db/migrations/107_native_document_asset_refs.py (not served here)
- backend/app/db/migrations/108_table_row_commit_cas.py (not served here)
- backend/app/db/migrations/109_users_email_lower_uniq.py (not served here)
- backend/app/db/migrations/110_search_degradation_daily.py (not served here)
- backend/app/db/migrations/111_bm25_recompute_resume.py (not served here)
- backend/app/db/migrations/112_edges_resource_identity.py (not served here)
- backend/app/db/migrations/113_bm25_vocab_epoch.py (not served here)
- backend/app/db/migrations/114_user_avatars.py (not served here)
- backend/app/db/migrations/115_legacy_adoption_history.py (not served here)
- backend/app/db/migrations/116_publication_password_budgets.py (not served here)
- backend/app/db/migrations/117_native_recent_order.py (not served here)
- backend/app/db/migrations/118_table_page_order.py (not served here)
- backend/app/db/migrations/121_sso_identity_operations.py (not served here)
- backend/app/db/migrations/121_sso_identity_operations.sql (not served here)
- backend/app/db/migrations/122_sso_management_targets.py (not served here)
- backend/app/db/migrations/122_sso_management_targets.sql (not served here)
- backend/app/db/migrations/123_sso_callback_evidence.py (not served here)
- backend/app/db/migrations/123_sso_callback_evidence.sql (not served here)
- backend/app/db/migrations/124_prepared_sso_targets.py (not served here)
- backend/app/db/migrations/124_prepared_sso_targets.sql (not served here)
- backend/app/db/migrations/125_sso_operation_attempts.py (not served here)
- backend/app/db/migrations/125_sso_operation_attempts.sql (not served here)
- backend/app/db/migrations/126_platform_service_bootstrap.py (not served here)
- backend/app/db/migrations/126_platform_service_bootstrap.sql (not served here)
- backend/app/db/migrations/127_sso_operation_requests.py (not served here)
- backend/app/db/migrations/127_sso_operation_requests.sql (not served here)
- backend/app/db/migrations/128_approval_service_bootstrap.py (not served here)
- backend/app/db/migrations/128_approval_service_bootstrap.sql (not served here)
- backend/app/db/migrations/129_sso_request_recovery.py (not served here)
- backend/app/db/migrations/129_sso_request_recovery.sql (not served here)
- backend/app/db/postgres.py (not served here)
- backend/app/db/transient.py (not served here)
- backend/app/exceptions.py (not served here)
- backend/app/http_middleware.py (not served here)
- backend/app/logging_redaction.py (not served here)
- backend/app/main.py (not served here)
- backend/app/models/__init__.py (not served here)
- backend/app/models/activity.py (not served here)
- backend/app/models/admin_sso.py (not served here)
- backend/app/models/document.py (not served here)
- backend/app/models/document_preconditions.py (not served here)
- backend/app/models/events.py (not served here)
- backend/app/models/file.py (not served here)
- backend/app/models/knowledge.py (not served here)
- backend/app/models/pat_issuance.py (not served here)
- backend/app/models/user_avatar.py (not served here)
- backend/app/models/vault_scope.py (not served here)
- backend/app/openapi_contract.py (not served here)
- backend/app/process_role.py (not served here)
- backend/app/repositories/__init__.py (not served here)
- backend/app/repositories/document_repo.py (not served here)
- backend/app/repositories/events_repo.py (not served here)
- backend/app/repositories/native_revision_cutover_repo.py (not served here)
- backend/app/repositories/native_revision_migration_repo.py (not served here)
- backend/app/repositories/native_revision_repo.py (not served here)
- backend/app/repositories/notifications_repo.py (not served here)
- backend/app/repositories/table_data_repo.py (not served here)
- backend/app/repositories/table_registry_repo.py (not served here)
- backend/app/repositories/user_avatars_repo.py (not served here)
- backend/app/repositories/vault_external_git_repo.py (not served here)
- backend/app/repositories/vault_files_repo.py (not served here)
- backend/app/repositories/vault_repo.py (not served here)
- backend/app/repositories/vault_write_policy_repo.py (not served here)
- backend/app/services/__init__.py (not served here)
- backend/app/services/_backfill.py (not served here)
- backend/app/services/access_contributions.py (not served here)
- backend/app/services/access_service.py (not served here)
- backend/app/services/account_deletion_worker.py (not served here)
- backend/app/services/account_markers.py (not served here)
- backend/app/services/account_self_service.py (not served here)
- backend/app/services/account_service.py (not served here)
- backend/app/services/activity_filters.py (not served here)
- backend/app/services/adapters/__init__.py (not served here)
- backend/app/services/adapters/s3_adapter.py (not served here)
- backend/app/services/adapters/s3_credentials.py (not served here)
- backend/app/services/admin_auth_service.py (not served here)
- backend/app/services/admission_service.py (not served here)
- backend/app/services/agent_memory_service.py (not served here)
- backend/app/services/app_identity_service.py (not served here)
- backend/app/services/app_installation_service.py (not served here)
- backend/app/services/app_inventory_service.py (not served here)
- backend/app/services/app_legacy_adoption_service.py (not served here)
- backend/app/services/app_registry_service.py (not served here)
- backend/app/services/app_resource_service.py (not served here)
- backend/app/services/app_rollout_service.py (not served here)
- backend/app/services/app_rollout_worker.py (not served here)
- backend/app/services/approval_service_bootstrap.py (not served here)
- backend/app/services/asset_gc_worker.py (not served here)
- backend/app/services/asset_service.py (not served here)
- backend/app/services/audit_log.py (not served here)
- backend/app/services/auth_policy.py (not served here)
- backend/app/services/auth_service.py (not served here)
- backend/app/services/auth_verifier_profiles.py (not served here)
- backend/app/services/bm25_maintenance.py (not served here)
- backend/app/services/bridge_body_backfill.py (not served here)
- backend/app/services/browse_pages.py (not served here)
- backend/app/services/collection_service.py (not served here)
- backend/app/services/delete_worker.py (not served here)
- backend/app/services/document_counters.py (not served here)
- backend/app/services/document_idempotency.py (not served here)
- backend/app/services/document_service.py (not served here)
- backend/app/services/edge_boundary.py (not served here)
- backend/app/services/embed_worker.py (not served here)
- backend/app/services/event_tail_service.py (not served here)
- backend/app/services/events_publisher.py (not served here)
- backend/app/services/external_git_capability.py (not served here)
- backend/app/services/external_git_poller.py (not served here)
- backend/app/services/external_git_retirement.py (not served here)
- backend/app/services/external_git_runner.py (not served here)
- backend/app/services/external_git_service.py (not served here)
- backend/app/services/external_git_validation.py (not served here)
- backend/app/services/external_identity_contract.py (not served here)
- backend/app/services/file_service.py (not served here)
- backend/app/services/git_service.py (not served here)
- backend/app/services/grep_replace.py (not served here)
- backend/app/services/health.py (not served here)
- backend/app/services/http_pool.py (not served here)
- backend/app/services/image_decode.py (not served here)
- backend/app/services/index_service.py (not served here)
- backend/app/services/keycloak_oidc.py (not served here)
- backend/app/services/kg_service.py (not served here)
- backend/app/services/knowledge_io.py (not served here)
- backend/app/services/legacy_revision_bridge.py (not served here)
- backend/app/services/lifecycle.py (not served here)
- backend/app/services/llm_service.py (not served here)
- backend/app/services/local_session_keys.py (not served here)
- backend/app/services/m1_binary_store.py (not served here)
- backend/app/services/m1_file_measurement.py (not served here)
- backend/app/services/m1_file_transfer_reaper.py (not served here)
- backend/app/services/m1_native_grep_service.py (not served here)
- backend/app/services/m1_native_text_file_bridge.py (not served here)
- backend/app/services/m1_pg_body_store.py (not served here)
- backend/app/services/m1_reference_payload_store.py (not served here)
- backend/app/services/mcp_oauth_preconditions.py (not served here)
- backend/app/services/metadata_worker.py (not served here)
- backend/app/services/model_gateway.py (not served here)
- backend/app/services/native_asset_ref_backfill.py (not served here)
- backend/app/services/native_derived_worker.py (not served here)
- backend/app/services/native_document_assets.py (not served here)
- backend/app/services/native_document_service.py (not served here)
- backend/app/services/native_file_projection.py (not served here)
- backend/app/services/native_payload_verification.py (not served here)
- backend/app/services/native_publication_binding.py (not served here)
- backend/app/services/native_revision_authority.py (not served here)
- backend/app/services/native_revision_backend.py (not served here)
- backend/app/services/native_revision_backfill.py (not served here)
- backend/app/services/native_revision_cutover.py (not served here)
- backend/app/services/native_revision_reconcile.py (not served here)
- backend/app/services/native_revision_service.py (not served here)
- backend/app/services/native_revision_shadow.py (not served here)
- backend/app/services/native_revision_shadow_reader.py (not served here)
- backend/app/services/notification_producer.py (not served here)
- backend/app/services/notification_service.py (not served here)
- backend/app/services/notification_worker.py (not served here)
- backend/app/services/okf.py (not served here)
- backend/app/services/password_service.py (not served here)
- backend/app/services/platform_service_bootstrap.py (not served here)
- backend/app/services/platform_service_bootstrap_probe.py (not served here)
- backend/app/services/publication_directory.py (not served here)
- backend/app/services/publication_rate_limit.py (not served here)
- backend/app/services/publication_service.py (not served here)
- backend/app/services/queue_rescuer.py (not served here)
- backend/app/services/raw_mime_policy.py (not served here)
- backend/app/services/recent_cursor.py (not served here)
- backend/app/services/recovery_admin_service.py (not served here)
- backend/app/services/rerank_service.py (not served here)
- backend/app/services/resource_hash.py (not served here)
- backend/app/services/resource_integrity.py (not served here)
- backend/app/services/revision_backend.py (not served here)
- backend/app/services/revision_install_config.py (not served here)
- backend/app/services/role_authority.py (not served here)
- backend/app/services/role_sync.py (not served here)
- backend/app/services/row_query_ast.py (not served here)
- backend/app/services/row_query_base.py (not served here)
- backend/app/services/row_query_shape.py (not served here)
- backend/app/services/row_query_string.py (not served here)
- backend/app/services/s3_delete_worker.py (not served here)
- backend/app/services/search_capabilities.py (not served here)
- backend/app/services/search_degradation_stats.py (not served here)
- backend/app/services/search_filters.py (not served here)
- backend/app/services/search_service.py (not served here)
- backend/app/services/search_update_status.py (not served here)
- backend/app/services/service_authority_service.py (not served here)
- backend/app/services/skill_policy.py (not served here)
- backend/app/services/skill_reservation_backfill.py (not served here)
- backend/app/services/sparse_encoder.py (not served here)
- backend/app/services/sparse_shapes.py (not served here)
- backend/app/services/sso_account_sync.py (not served here)
- backend/app/services/sso_browser_session_crypto.py (not served here)
- backend/app/services/sso_browser_session_service.py (not served here)
- backend/app/services/sso_callback_urls.py (not served here)
- backend/app/services/sso_session_epoch.py (not served here)
- backend/app/services/standalone_sso_bootstrap.py (not served here)
- backend/app/services/standalone_sso_keycloak.py (not served here)
- backend/app/services/standalone_sso_receipt.py (not served here)
- backend/app/services/table_migration_service.py (not served here)
- backend/app/services/table_row_query.py (not served here)
- backend/app/services/table_row_write.py (not served here)
- backend/app/services/table_schema_service.py (not served here)
- backend/app/services/table_service.py (not served here)
- backend/app/services/template_registry.py (not served here)
- backend/app/services/token_issuer_policy.py (not served here)
- backend/app/services/tool_usage.py (not served here)
- backend/app/services/uri_service.py (not served here)
- backend/app/services/user_avatar_service.py (not served here)
- backend/app/services/user_directory.py (not served here)
- backend/app/services/user_identity.py (not served here)
- backend/app/services/user_sql_executor.py (not served here)
- backend/app/services/vault_backfill.py (not served here)
- backend/app/services/vault_creation_capabilities.py (not served here)
- backend/app/services/vault_skill_service.py (not served here)
- backend/app/services/vector_store/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/README.md (not served here)
- backend/app/services/vector_store/_grpc/proto/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/catalog/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/catalog/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/catalog/v1/catalog.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/catalog/v1/catalog_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/catalog/v1/catalog_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/common/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/common/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/common/v1/common.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/common/v1/common_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/common/v1/common_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/export/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/export/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/export/v1/export.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/health/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/health/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/health/v1/health.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/health/v1/health_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/health/v1/health_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/ingest/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/ingest/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/ingest/v1/ingest.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/ingest/v1/ingest_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/ingest/v1/ingest_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/log/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/log/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/log/v1/log.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/node/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/node/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/node/v1/node.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/query/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/query/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/query/v1/query.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/query/v1/query_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/query/v1/query_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/segment/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/segment/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/segment/v1/segment.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/segment/v1/segment_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/segment/v1/segment_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/sql/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/sql/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/sql/v1/sql.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/storage/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/storage/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/storage/v1/storage.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/storage/v1/storage_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/storage/v1/storage_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/table/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/table/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/table/v1/table.proto (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/table/v1/table_pb2.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/table/v1/table_pb2_grpc.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/utility/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/utility/v1/__init__.py (not served here)
- backend/app/services/vector_store/_grpc/proto/coral/utility/v1/utility.proto (not served here)
- backend/app/services/vector_store/_seahorse_common.py (not served here)
- backend/app/services/vector_store/base.py (not served here)
- backend/app/services/vector_store/factory.py (not served here)
- backend/app/services/vector_store/pgvector.py (not served here)
- backend/app/services/vector_store/posting_search.py (not served here)
- backend/app/services/vector_store/qdrant.py (not served here)
- backend/app/services/vector_store/seahorse_cloud.py (not served here)
- backend/app/services/vector_store/seahorse_db.py (not served here)
- backend/app/services/vector_store/seahorse_db_grpc.py (not served here)
- backend/app/services/vector_store/sparse_shape_state.py (not served here)
- backend/app/services/workload_identity.py (not served here)
- backend/app/services/workspace_summary.py (not served here)
- backend/app/services/write_lane.py (not served here)
- backend/app/sso/__init__.py (not served here)
- backend/app/sso/adopt_prepared_target.py (not served here)
- backend/app/sso/brokered_account_guard.py (not served here)
- backend/app/sso/callback_evidence.py (not served here)
- backend/app/sso/cleanup_prepared_target.py (not served here)
- backend/app/sso/identity_migration.py (not served here)
- backend/app/sso/identity_operations.py (not served here)
- backend/app/sso/keycloak_admin.py (not served here)
- backend/app/sso/local_realm.py (not served here)
- backend/app/sso/management_targets.py (not served here)
- backend/app/sso/models.py (not served here)
- backend/app/sso/operation_attempts.py (not served here)
- backend/app/sso/operation_request_scope.py (not served here)
- backend/app/sso/operation_requests.py (not served here)
- backend/app/sso/prepare_target_host.py (not served here)
- backend/app/sso/providers/__init__.py (not served here)
- backend/app/sso/providers/generic_oidc.py (not served here)
- backend/app/sso/providers/keycloak_oidc.py (not served here)
- backend/app/sso/realm_residue.py (not served here)
- backend/app/sso/registry.py (not served here)
- backend/app/sso/runtime_identity.py (not served here)
- backend/app/sso/sealing.py (not served here)
- backend/app/stats/__init__.py (not served here)
- backend/app/stats/golden_v1.json (not served here)
- backend/app/stats/golden_v1_unmeasured.json (not served here)
- backend/app/stats/listener.py (not served here)
- backend/app/stats/sampler.py (not served here)
- backend/app/stats/schema_v1.json (not served here)
- backend/app/util/__init__.py (not served here)
- backend/app/util/errors.py (not served here)
- backend/app/util/git_refs.py (not served here)
- backend/app/util/text.py (not served here)
- backend/app/utils.py (not served here)
- backend/app/worker_health.py (not served here)
- backend/app/worker_main.py (not served here)
- backend/mcp_server/__init__.py (not served here)
- backend/mcp_server/help.py (not served here)
- backend/mcp_server/http_app.py (not served here)
- backend/mcp_server/instructions.py (not served here)
- backend/mcp_server/response_projection.py (not served here)
- backend/mcp_server/server.py (not served here)
- backend/mcp_server/tools.py (not served here)
- backend/mcp_server/vault_contract.py (not served here)
- backend/pyproject.toml (not served here)
- backend/scripts/audit_edge_vault_boundary.py (not served here)
- backend/scripts/backfill_bm25_vector.py (not served here)
- backend/scripts/backfill_skill_reservation.py (not served here)
- backend/scripts/backfill_vault_id.py (not served here)
- backend/scripts/benchmark_search_posting.py (not served here)
Advantages
- Local-first: the memory stays in files or a database on your own machine (a rule-derived fact from the brain’s files, evidence: README.md)
- Works with 14 MCP clients (a rule-derived fact from the brain’s files, evidence: README.md)
- No API key is named in its files (a rule-derived fact from the brain’s files, evidence: README.md)
Limitations
- Needs a database (PostgreSQL, Qdrant, Redis) (a rule-derived fact from the brain’s files, evidence: README.md)
- Runs code automatically: review what it runs before you open it (a rule-derived fact from the brain’s files)
- Link-only: AutoGineer links to the files instead of serving them (a rule-derived fact from the brain’s files)
Security
Risk level: Medium risk
This brain runs
Agent instructions that run or fetch something (30)
.claude/agents/worker.md:Run the check that exercises the change, and return the change, the check's result and any uncertainty.AGENTS.md:`.codex/` and `.claude/agents/` are rendered from that file by `python scripts/agent-roles.py`;AGENTS.md:**Verify before saying something passes.** `bash scripts/check.sh` is the static gate CI runs;AGENTS.md:Also run the checks that exercise what you changed: the frontend gate below for UI work, the suites in `scripts/ci/README.md` for backend behavior.AGENTS.md:Report what ran and its result, and say so when a check was not run.AGENTS.md:**Build guard**: `frontend/scripts/design-check.mjs` (`npm run design:check`, also in `build`) fails on raw 6-digit hex in components + the legacy `bg-foreground text-background` slab.AGENTS.md:**Frontend check gate** (run before committing frontend changes): `cd frontend && npm run design:check && npm run typecheck && npm run lint && npm run test`.AGENTS.md:Run E2E against the deployed URL: `AKB_URL=https://<your-host> bash backend/tests/test_mcp_e2e.sh`.AGENTS.md:npm package: `akb-mcp` on npmjs.org.AGENTS.md:**Backend**: bump `backend/pyproject.toml`, add CHANGELOG entry, PR + merge → `git tag -a backend-vX.Y.Z <merge-commit> -m "..."` → push → `gh release create backend-vX.Y.Z [--latest] --notes "..."` → build the release image from the bumped version.AGENTS.md:**Proxy**: bump `packages/akb-mcp-client/package.json`, add CHANGELOG entry, PR + merge → for an authorized release, run `cd packages/akb-mcp-client && npm publish --access public` using the verified publishing account → `git tag -a akb-mcp-vX.Y.Z <bump-commit> -m "..."` → push → `gh re …[+54 chars]AGENTS.md:**Persistent linked worktree** per vault at `/data/vaults/_worktrees/{vault_name}` (created once via `git worktree add`).plugins/claude/akb-sessions/skills/session-ingest/SKILL.md:# --skip-git-repo-check: the receiver may run in a non-git pwd (delegateplugins/claude/akb-sessions/skills/session-ingest/SKILL.md:If commits were found, run:plugins/claude/akb-sessions/skills/session-ingest/SKILL.md:git log --oneline {earliest_commit_hash}^..{latest_commit_hash}plugins/claude/akb-sessions/skills/session-ingest/SKILL.md:git diff --stat {earliest_commit_hash}^..{latest_commit_hash}plugins/claude/akb-sessions/skills/session-ingest/SKILL.md:git remote get-url originplugins/claude/akb-wiki/skills/akb-ingest/SKILL.md:| Target shape | `<chosen-agent>` | Forwarded flags | |---|---|---| | Local path that exists, or a glob pattern (`*`, `?`, `[`) | `ingest-doc` | `--lang`, `--raw`/`--no-raw` | | `https?://…/…/pull/<n>` on `github.com` | `ingest-pr` | `--repo` | | `https?://…/…/releases/tag/<tag>` on `g …[+742 chars]plugins/claude/akb-wiki/skills/akb-ingest/SKILL.md:For a GitHub URL the local clone still comes from `--repo` (or cwd), **not** the URL — only the number / tag / SHA is taken from the URL.· uses the networkplugins/claude/akb-wiki/skills/akb-query/SKILL.md:Run only the strategies Phase 1 chose.plugins/claude/akb-wiki/skills/akb-query/SKILL.md:**Exception:** when the relational strategy is selected but no anchor URI is known yet, that strategy is *not* independent — run the hybrid search first to find the anchor, then issue `akb_relations` / `akb_graph` in a follow-up block.plugins/codex/akb-sessions/skills/session-ingest/SKILL.md:# --skip-git-repo-check: the receiver may run in a non-git pwd (delegateplugins/codex/akb-sessions/skills/session-ingest/SKILL.md:If commits were found, run:plugins/codex/akb-sessions/skills/session-ingest/SKILL.md:git log --oneline {earliest_commit_hash}^..{latest_commit_hash}plugins/codex/akb-sessions/skills/session-ingest/SKILL.md:git diff --stat {earliest_commit_hash}^..{latest_commit_hash}plugins/codex/akb-sessions/skills/session-ingest/SKILL.md:git remote get-url originplugins/codex/akb-wiki/skills/akb-ingest/SKILL.md:| Target shape | `<chosen-agent>` | Forwarded flags | |---|---|---| | Local path that exists, or a glob pattern (`*`, `?`, `[`) | `ingest-doc` | `--lang`, `--raw`/`--no-raw` | | `https?://…/…/pull/<n>` on `github.com` | `ingest-pr` | `--repo` | | `https?://…/…/releases/tag/<tag>` on `g …[+742 chars]plugins/codex/akb-wiki/skills/akb-ingest/SKILL.md:For a GitHub URL the local clone still comes from `--repo` (or cwd), **not** the URL — only the number / tag / SHA is taken from the URL.· uses the networkplugins/codex/akb-wiki/skills/akb-query/SKILL.md:Run only the strategies Phase 1 chose.plugins/codex/akb-wiki/skills/akb-query/SKILL.md:**Exception:** when the relational strategy is selected but no anchor URI is known yet, that strategy is *not* independent — run the hybrid search first to find the anchor, then issue `akb_relations` / `akb_graph` in a follow-up block.
Hooks (4)
plugins/claude/akb-claude-code/hooks/hooks.json(SessionStart):"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"plugins/claude/akb-claude-code/hooks/hooks.json(UserPromptSubmit):"${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit.sh"plugins/claude/akb-claude-code/hooks/hooks.json(PreCompact):"${CLAUDE_PLUGIN_ROOT}/hooks/pre-compact.sh"plugins/claude/akb-claude-code/hooks/hooks.json(SessionEnd):"${CLAUDE_PLUGIN_ROOT}/hooks/session-end.sh"
MCP servers (2)
plugins/claude/akb-wiki/.mcp.json(akb):npx akb-mcp --insecureplugins/codex/akb-wiki/.mcp.json(akb):npx akb-mcp --insecure
- Medium risk: runs-mcp-server-unpinned-runner (plugins/claude/akb-wiki/.mcp.json)
- Medium risk: runs-instruction-instruction-network (plugins/claude/akb-wiki/skills/akb-ingest/SKILL.md:71)
- Medium risk: runs-mcp-server-unpinned-runner (plugins/codex/akb-wiki/.mcp.json)
- Medium risk: runs-instruction-instruction-network (plugins/codex/akb-wiki/skills/akb-ingest/SKILL.md:69)
- Low risk: scripts-present (backend/tests/test_mcp_e2e.sh)
- Low risk: scripts-present (plugins/claude/akb-claude-code/hooks/pre-compact.sh)
- Low risk: scripts-present (plugins/claude/akb-claude-code/hooks/session-end.sh)
- Low risk: scripts-present (plugins/claude/akb-claude-code/hooks/session-start.sh)
- Low risk: scripts-present (plugins/claude/akb-claude-code/hooks/user-prompt-submit.sh)
- Low risk: scripts-present (scripts/agent-roles.py)
- Low risk: scripts-present (scripts/check.sh)
- Low risk: scripts-present (scripts/ci/e2e_suite_runner.py)
Attribution and licence
- Created by
- Dnotitia
- Publisher
- Dnotitia (Official Dnotitia project)
- Source
- dnotitia/akb · commit 230e3ee
- Licence
- Business Source License 1.1 (The licence does not allow AutoGineer to copy these files.)
- Synced
AutoGineer is not affiliated with or endorsed by Dnotitia.
Install from source
The licence does not allow AutoGineer to copy these files. dnotitia/akb at 230e3ee