CtrlK
BlogDocsLog inGet started
Tessl Logo

list-projects

Lists all projects with stored memories for the current user, showing memory counts and last activity dates. Use when checking which projects have memories, comparing memory distribution across repos, or finding a specific project scope.

76

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Mem0 List Projects

Show all known project scopes for the current user.

Execution

Step 1: Fetch memories to discover app_ids

There is no dedicated "list projects" API endpoint. Discover projects by fetching the user's memories across all scopes.

Important: A filter with only user_id triggers implicit null scoping — it excludes memories that have a non-null app_id. Run two queries and merge:

  1. Null-scoped: get_memories with filters={"AND": [{"user_id": "<active_user_id>"}]}, page_size=200 — catches memories without app_id
  2. App-scoped: get_memories with filters={"AND": [{"user_id": "<active_user_id>"}, {"app_id": {"exists": true}}]}, page_size=200 — catches memories with any app_id

Run both calls in parallel. Merge results, deduplicate by memory id.

If either response indicates more pages, paginate (up to 1000 total).

Step 2: Extract distinct projects

For each memory, determine project by:

  1. Top-level app_id field (preferred)
  2. metadata.project_id (legacy memories)
  3. metadata.project (oldest format)
  4. "(unscoped)" if none found

Group by resolved project name. For each project, count:

  • Total memories
  • Most recent created_at date
  • Top 3 metadata.type values by frequency

Step 3: Display

## mem0 projects

  <app_id_1>  <count> memories  (last: <date>) ← current
  <app_id_2>  <count> memories  (last: <date>)

<N> projects, <M> total memories

Mark current project with ← current. Sort by memory count descending.

Step 4: Empty state

If zero memories found:

No projects found. Run /mem0:onboard to get started.
Repository
mem0ai/mem0
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.