forgetful
Opensource Memory for Agents
File Explorer
- build.yml
- ci.yml
- e2e.yml
- publish.yml
- __init__.py
- db_postgres_impl.py
- db_sqlite_impl.py
- 0c7b964dd1e7_initial_schema_with_entity_many_to_many.py
- 20251216143413_add_aka_to_entities.py
- 20260106_add_activity_log_table.py
- 20260106_add_provenance_tracking_to_memories.py
- 20260312_add_plans_tasks_criteria_dependencies.py
- 20260315_add_files_table.py
- 20260321_add_skills_table.py
- 20260408_add_provenance_to_all_object_types.py
- 20260704_add_memory_usage_tracking.py
- env.py
- README
- script.py.mako
- __init__.py
- auth.py
- logging_config.py
- settings.py
- __init__.py
- event_bus.py
- auth.py
- logging_middleware.py
- __init__.py
- activity_models.py
- code_artifact_models.py
- document_models.py
- entity_models.py
- file_models.py
- graph_models.py
- memory_models.py
- models.py
- plan_models.py
- project_models.py
- skill_models.py
- tool_registry_models.py
- user_models.py
- __init__.py
- activity_protocol.py
- code_artifact_protocol.py
- document_protocol.py
- entity_protocol.py
- executor.py
- file_protocol.py
- memory_protocol.py
- plan_protocol.py
- project_protocol.py
- skill_protocol.py
- task_protocol.py
- user_protocol.py
- __init__.py
- embedding_adapter.py
- fastembed_offline.py
- reranker_adapter.py
- __init__.py
- activity_repository.py
- code_artifact_repository.py
- document_repository.py
- entity_repository.py
- file_repository.py
- memory_repository.py
- plan_repository.py
- postgres_adapter.py
- postgres_tables.py
- project_repository.py
- skill_repository.py
- task_repository.py
- user_repository.py
- activity_repository.py
- code_artifact_repository.py
- document_repository.py
- entity_repository.py
- file_repository.py
- memory_repository.py
- plan_repository.py
- project_repository.py
- skill_repository.py
- sqlite_adapter.py
- sqlite_tables.py
- task_repository.py
- user_repository.py
- __init__.py
- helpers.py
- __init__.py
- activity.py
- auth.py
- code_artifacts.py
- documents.py
- entities.py
- files.py
- graph.py
- health.py
- memories.py
- plans.py
- projects.py
- skills.py
- tasks.py
- __init__.py
- auth_commands.py
- context.py
- local_executor.py
- parser.py
- paths.py
- remote_executor.py
- render.py
- verbs.py
- __init__.py
- code_artifact_tools.py
- document_tools.py
- entity_tools.py
- memory_tools.py
- meta_tools.py
- pagination.py
- project_tools.py
- scope_resolver.py
- skill_tools.py
- tool_adapters.py
- tool_metadata_registry.py
- tool_registry.py
- user_tools.py
- __init__.py
- __init__.py
- activity_service.py
- backup_service.py
- code_artifact_service.py
- document_service.py
- entity_service.py
- file_service.py
- graph_service.py
- memory_service.py
- plan_service.py
- project_service.py
- re_embedding_service.py
- skill_service.py
- task_service.py
- user_service.py
- provenance.py
- pydantic_helper.py
- token_counter.py
- __init__.py
- bootstrap.py
- exceptions.py
- version.py
- .env.example
- docker-compose.postgres.yml
- docker-compose.sqlite.yml
- docker-compose.yml
- Dockerfile
- forgetful-memory.agent.md
- knowledge-explorer.agent.md
- memory-curator.agent.md
- README.md
- README.md
- cli_plan.md
- encode-repo.toml
- forgetful-setup.toml
- memory-explore.toml
- memory-list.toml
- memory-save.toml
- memory-search.toml
- README.md
- avatar.png
- Forgetful Architecture.drawio.png
- Forgetful Architecture.drawio_transparent.png
- hero_banner.png
- layers.png
- Memory Autolinking.drawio.png
- encode-repo.md
- forgetful-setup.md
- memory-explore.md
- memory-list.md
- memory-save.md
- memory-search.md
- README.md
- README.md
- comprehensive_project_understanding_prompt.md
- custom_agent_integration.md
- example_system_prompt.md
- knowledge_base_bootstrap_prompt.md
- prompts_overview.md
- rapid_project_scan_prompt.md
- api_reference.md
- concepts.md
- configuration.md
- connectivity_guide.md
- contributors.md
- embedding_migration.md
- features_roadmap.md
- OFFLINE_SETUP.md
- search.md
- self-hosting-guide.md
- tool_reference.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- README.md
- Dockerfile
- opencode.json
- runner.py
- __init__.py
- __main__.py
- config.py
- container.py
- prompts.py
- README.md
- report.py
- server.py
- walkthrough.py
- conftest.py
- test_api_activity.py
- test_auth_e2e.py
- test_cli_postgres_e2e.py
- test_code_artifact_tools_e2e.py
- test_document_tools_e2e.py
- test_entity_tools_e2e.py
- test_file_tools_e2e.py
- test_graph_e2e.py
- test_health_e2e.py
- test_link_memories_no_autolink_e2e.py
- test_memory_tools_e2e.py
- test_memory_usage_e2e.py
- test_memory_usage_tracking_disabled_e2e.py
- test_meta_tools_e2e.py
- test_plan_tools_e2e.py
- test_project_tools_e2e.py
- test_provenance_e2e.py
- test_re_embedding_e2e.py
- test_reranking_e2e.py
- test_skill_tools_e2e.py
- test_task_tools_e2e.py
- test_user_tools_e2e.py
- test_zz_backup_restore_e2e.py
- conftest.py
- test_api_activity_sqlite.py
- test_api_auth.py
- test_api_code_artifacts.py
- test_api_documents.py
- test_api_entities.py
- test_api_files.py
- test_api_graph.py
- test_api_graph_limit_settings.py
- test_api_memories.py
- test_api_plans.py
- test_api_projects.py
- test_api_skills.py
- test_api_tasks.py
- test_auth_cache_sqlite.py
- test_auth_sqlite.py
- test_cli_passthrough.py
- test_cli_remote.py
- test_cli_verbs.py
- test_code_artifact_tools_sqlite.py
- test_document_tools_sqlite.py
- test_entity_tools_sqlite.py
- test_feature_flags_sqlite.py
- test_file_tools_sqlite.py
- test_harness_server.py
- test_health_sqlite.py
- test_link_memories_no_autolink_sqlite.py
- test_memory_tools_sqlite.py
- test_meta_tools_sqlite.py
- test_plan_tools_sqlite.py
- test_project_tools_sqlite.py
- test_provenance_sqlite.py
- test_re_embedding_sqlite.py
- test_reranking_sqlite.py
- test_scoped_permissions_sqlite.py
- test_skill_tools_sqlite.py
- test_task_tools_sqlite.py
- test_user_tools_sqlite.py
- conftest.py
- test_auth.py
- test_auth_cache.py
- test_auth_factory.py
- test_auth_info.py
- test_backup_service.py
- test_bootstrap.py
- test_cli_dispatch.py
- test_cli_local_executor.py
- test_cli_remote_executor.py
- test_cli_verbs_mapping.py
- test_code_artifact_service.py
- test_config_precedence.py
- test_document_service.py
- test_entity_service.py
- test_event_bus.py
- test_fastembed_offline.py
- test_file_service.py
- test_graph_service_plan_task.py
- test_harness_cli.py
- test_harness_config.py
- test_harness_container.py
- test_harness_report.py
- test_harness_walkthrough.py
- test_http_reranker_adapter.py
- test_memory_service.py
- test_memory_usage_tracking.py
- test_meta_tools_docstrings.py
- test_ollama_embeddings_adapter.py
- test_openai_embeddings_adapter.py
- test_plan_service.py
- test_project_service.py
- test_provenance.py
- test_re_embedding_service.py
- test_rest_auth.py
- test_scope_resolver.py
- test_service_activity_events.py
- test_skill_frontmatter_quoting.py
- test_skill_service.py
- test_targeted_rebuild_sqlite.py
- test_task_service.py
- test_tool_registry.py
- test_user_service.py
- .dockerignore
- .gitignore
- .python-version
- AGENTS.md
- alembic.ini
- CLAUDE.md
- forgetful.mycelium.json
- GEMINI.md
- LICENCE.md
- main.py
- org_knowledge_proposal.md
- pyproject.toml
- pytest.ini
- README.md
- ruff.toml
- uv.lock
# Use via CDN
jsDelivrjsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.
Link
Example
Command Glossary
Commands referenced in this DOCs, explained below.
docker compose
View Details ▼
docker compose
Run and manage multi container Docker applications.
docker compose ps
List all running containers:
docker compose up {{[-d|--detach]}}
Create and start all containers in the background using a `docker-compose.yml` file from the current directory:
docker compose up --build
Start all containers, rebuild if necessary:
git clone
View Details ▼
git clone
Clone an existing repository.
git clone {{remote_repository_location}} {{path/to/directory}}
Clone an existing repository into a new directory (the default directory is the repository name):
git clone --recursive {{remote_repository_location}}
Clone an existing repository and its submodules:
git clone {{[-n|--no-checkout]}} {{remote_repository_location}}
Clone only the `.git` directory of an existing repository:
uv run
View Details ▼
uv run
Run a command or script in the project environment.
uv run {{path/to/script.py}}
Run a Python script:
uv run {{[-m|--module]}} {{module_name}}
Run a Python module:
uv run {{[-w|--with]}} {{package}} {{command}}
Run a command with additional packages installed temporarily:
uv sync
View Details ▼
uv sync
Update the project's environment to match the lockfile.
uv sync
Sync the project environment with the lockfile:
uv sync --all-extras
Sync and include all optional dependencies:
uv sync --extra {{extra_name}}
Sync with specific optional dependencies:
uv tool
View Details ▼
uv tool
Install and run commands provided by Python packages.
uv tool run {{command}}
Run a command from a package, without installing it:
uv tool install {{package}}
Install a Python package system-wide:
uv tool upgrade {{package}}
Upgrade an installed Python package:
uvx
View Details ▼
uvx
This command is an alias of `uv tool run`.
tldr uv tool
View documentation for the original command:
# Project Badges
// repository documentation
Was this content helpful?
(0 ratings)