stark-ai-de/agent-skills / incubator/skills/engineering-workflows/hindsight-memory
hindsight-memory
VerifiedSet up, diagnose, enable or use scoped Hindsight memory without requiring Greppy. Use when the user requests approved project or workspace memory, compact Codex/pi session outcomes or source-backed reflection. Not for global memory cleanup or implicit ingestion of search-indexed repositories.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.4 KB |
| assets/compose.yaml | config | 2.7 KB |
| assets/parser.nix | other | 783 B |
| assets/project.example.json | config | 873 B |
| assets/workspace.example.json | config | 1.1 KB |
| diagnostics/bank_aliases.py | script | 7.0 KB |
| diagnostics/workspace_status.py | script | 2.8 KB |
| references/setup.md | markdown | 23.9 KB |
| scripts/activate.py | script | 3.2 KB |
| scripts/build_parser.py | script | 2.6 KB |
| scripts/initialize.py | script | 5.1 KB |
| scripts/mcp_launcher.py | script | 9.1 KB |
| scripts/metrics.py | script | 4.6 KB |
| scripts/private_policy.py | script | 1.4 KB |
| scripts/project_scope.py | script | 13.7 KB |
| scripts/session_hook.py | script | 6.1 KB |
| scripts/session_parser.py | script | 11.0 KB |
| scripts/weekly.py | script | 19.5 KB |
| scripts/worker.py | script | 8.8 KB |
| scripts/workspace_scope.py | script | 13.1 KB |
assets/compose.yaml
View on GitHubname: "@COMPOSE_PROJECT@"
services:
hindsight:
image: ghcr.io/vectorize-io/hindsight:1.2.1@sha256:d2bc230a714e933affd63753e181a0579328fdcbbc021800a76e0bc7b6e76b31
network_mode: host
restart: unless-stopped
stop_grace_period: 75s
shm_size: 1gb
env_file:
- "@RUNTIME_ENV@"
environment:
HINDSIGHT_API_HOST: 127.0.0.1
HINDSIGHT_API_PORT: "18888"
HINDSIGHT_CP_HOSTNAME: 127.0.0.1
HINDSIGHT_CP_PORT: "19999"
HINDSIGHT_CP_DATAPLANE_API_URL: http://127.0.0.1:18888
HINDSIGHT_API_TENANT_EXTENSION: private_policy:PrivateTenantExtension
HINDSIGHT_API_OPERATION_VALIDATOR_EXTENSION: private_policy:PrivateStorageValidator
PYTHONPATH: /hindsight
HINDSIGHT_API_STORE_DOCUMENT_TEXT: "false"
HINDSIGHT_API_LLM_TRACE_ENABLED: "false"
HINDSIGHT_API_OTEL_TRACES_ENABLED: "false"
HINDSIGHT_API_LOG_LEVEL: warning
HINDSIGHT_API_LLM_DEBUG_DUMP_4XX: "false"
HINDSIGHT_API_FAIL_ON_EXTRACTION_ERRORS: "true"
HINDSIGHT_API_WORKER_ID: hindsight-greppy
volumes:
- hindsight-data:/home/hindsight/.pg0
- hindsight-auth:/home/hindsight/codex-auth
- type: bind
source: "@POLICY@"
target: /hindsight/private_policy.py
read_only: true
logging:
driver: json-file
options:
max-size: 10m
max-file: "3"
weekly:
image: ghcr.io/vectorize-io/hindsight:1.2.1@sha256:d2bc230a714e933affd63753e181a0579328fdcbbc021800a76e0bc7b6e76b31
profiles: ["job"]
network_mode: host
entrypoint: ["/app/api/.venv/bin/python3", "/hindsight/worker.py"]
auth-init:
image: ghcr.io/vectorize-io/hindsight:1.2.1@sha256:d2bc230a714e933affd63753e181a0579328fdcbbc021800a76e0bc7b6e76b31
profiles: ["job"]
network_mode: none
user: "0:0"
volumes:
- hindsight-auth:/home/hindsight/codex-auth
entrypoint: ["/bin/sh", "-c"]
command:
- |
dir=/home/hindsight/codex-auth
owner=$$(stat -c %u "$$dir")
if [ "$$owner" = 0 ] && [ -z "$$(ls -A "$$dir")" ]; then
chown 1000:1000 "$$dir"
chmod 700 "$$dir"
elif [ "$$owner" != 1000 ]; then
echo "Hindsight auth volume has an unexpected owner" >&2
exit 1
fi
auth:
image: ghcr.io/vectorize-io/hindsight:1.2.1@sha256:d2bc230a714e933affd63753e181a0579328fdcbbc021800a76e0bc7b6e76b31
profiles: ["job"]
network_mode: host
environment:
CODEX_HOME: /home/hindsight/codex-auth
volumes:
- hindsight-auth:/home/hindsight/codex-auth
- type: bind
source: "@CODEX@"
target: /hindsight/codex
read_only: true
entrypoint: ["/hindsight/codex"]
volumes:
hindsight-data:
hindsight-auth:
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |