---
title: "Getting Started"
description: "Configure where notes are saved and manage multiple projects."
canonical_url: "https://docs.basicmemory.com/local/getting-started"
---
# Getting Started

> Configure where notes are saved and manage multiple projects.

Already installed? (If not, start with [Quickstart: Local](https://docs.basicmemory.com/start-here/quickstart-local).) This page covers what comes next: where your notes are saved, working with multiple projects, and keeping Basic Memory updated.

---

## title: "Quickstart: Cloud"
icon: i-lucide-cloud
to: /start-here/quickstart-cloud

Connect in 2 minutes. No installation required.
::

<card icon="i-lucide-hard-drive" title="Quickstart: Local" to="https://docs.basicmemory.com/start-here/quickstart-local">

Install locally and run everything on your machine.

</card>

:::

---

## Choosing Where Notes Are Saved

By default, Basic Memory saves notes in a project called `main` in `~/basic-memory`. To save notes elsewhere:

### Use Your Existing Notes Folder

Ask your AI assistant directly:

```text
Create a new project called "my project" in the "/Users/yourname/Documents/Notes" directory
```

Then:

```text
Use "my project" for subsequent notes and searches.
```

Or use the command line:

```bash
# Point Basic Memory to your existing notes folder
basic-memory project add "my project" <path to your project>

# Make it your default location
basic-memory project default "my project"
```

<warning>

With the 1.0 tools, multiple addressable projects require the assistant to pass `project` or a project-qualified target on note and search calls. Changing the CLI default does not replace that explicit scope.

</warning>

**Want to use Obsidian?** Just open your folder location as a vault. See the [Obsidian Integration](https://docs.basicmemory.com/integrations/obsidian) guide.

<note>

**Advanced configuration**: Basic Memory stores its settings in `~/.basic-memory/config.json`. While CLI commands are recommended for configuration, you can edit this file directly. Changes require restarting Claude Desktop.

</note>

---

## Multi-Project Setup

Basic Memory supports multiple projects for organizing different knowledge bases (work, personal, research, etc.).

**How it works:**

When you start a conversation, the AI will:

1. Check your available projects
2. Suggest the most active project based on recent activity
3. Ask which project to use for this conversation
4. Pass your chosen project on subsequent tool calls

**Example:**

```text
You: "Let's work on documentation"

Claude: I see you have 3 projects: main, work-notes, personal
Your most active project is work-notes
Should I use work-notes for this task?

You: "Yes, let's use work-notes"
```

**Creating projects:**

```bash
# Command line
basic-memory project add "work-notes" ~/Documents/work

# Or ask your AI assistant
You: "Create a new project called 'work-notes' in ~/Documents/work"
```

**For users who primarily work in one project:**

Set a default for CLI commands that support fallback — it's the same setting the command above writes:

```bash
basic-memory project default "main"
```

For 1.0 MCP note and search calls, the assistant still names the project when several are addressable. To constrain an MCP session to one project, start the server with `basic-memory mcp --project main`; see the [User Guide](https://docs.basicmemory.com/local/user-guide#single-project-mode-locked).

---

## Staying Updated

To update Basic Memory when new versions are released:

```bash
# Update with uv
uv tool upgrade basic-memory

# Or Homebrew
brew upgrade basic-memory
```

<note>

After updating, restart Claude Desktop for changes to take effect.

</note>

---

## Next Steps

<card-group>
<card icon="i-lucide-book-open" title="User Guide" to="https://docs.basicmemory.com/local/user-guide">

Comprehensive usage instructions for daily workflows.

</card>

<card icon="i-lucide-file-text" title="Knowledge Format" to="https://docs.basicmemory.com/concepts/knowledge-format">

Learn how knowledge is structured with semantic patterns.

</card>

<card icon="i-lucide-terminal" title="CLI Reference" to="https://docs.basicmemory.com/reference/cli-reference">

Complete command line tools reference.

</card>

<card icon="i-lucide-wrench" title="Troubleshooting" to="https://docs.basicmemory.com/reference/troubleshooting">

Common issues and solutions.

</card>

<card icon="i-lucide-shield-check" title="Schema System" to="https://docs.basicmemory.com/concepts/schema-system">

Define and validate note structure with schemas.

</card>

<card icon="i-lucide-search" title="Semantic Search" to="https://docs.basicmemory.com/concepts/semantic-search">

Search by meaning with vector and hybrid modes.

</card>
</card-group>


## Sitemap

See the full [sitemap](https://docs.basicmemory.com/sitemap.md) for all pages.
