Workspace

Configure Artemis's personality, memory, and local configuration with workspace files.

Artemis uses a set of markdown files in ~/.artemis/workspace/ to define its identity, remember information, and customize its local tool guidelines.

SOUL.MD

Defines the agent's personality and communication style. Think of it as Artemis's identity config file.

# Artemis

You are Artemis, a personal AI assistant. You are warm, direct,
and technically competent. You prefer concise responses but will
elaborate when the topic requires depth.
This is the system prompt. It dictates how the agent should talk and act. 

I prefer agents that are direct and professional, without the cloying, subservient "As an AI..." qualifiers. You can rewrite this file to give Artemis whatever personality fits your workflow. The agent reads this file hot on every request, so you don't need to restart the gateway when you change it.

## OWNER.MD

This file contains facts about you. Artemis builds it during the initial onboarding conversation, but you can edit it manually whenever you want.

It's injected into the context window so the agent always knows things like your timezone, your preferred languages, and what projects you're actively working on.

## MEMORY.MD

The scratchpad. Artemis writes to this file to persist information across sessions.

```markdown
## 2026-03-28
- Eduardo prefers dark mode in all applications
- Fixed the Gmail OAuth flow

Whenever this file changes, the native ArtemisFileMemory class detects the modification and automatically chunks and vectors the contents into a local ChromaDB instance. This automated indexing ensures that semantic lookups remain in total sync with your filesystem—giving Artemis immediate access to historical context, without requiring manual database re-indexing.

TOOLS.MD

Environment-specific local notes, guidelines, and settings for the tools and machines Artemis runs on.

## Local Configuration
- Use PowerShell for shell commands on Windows
- SSH access is allowed to target dev-box
- Local web gateway port is 4081

Unlike SOUL.MD and OWNER.MD which are injected into every prompt for identity, the agent references TOOLS.MD specifically to adapt its tool parameters and commands to your local environment context.

Structure

By default, everything lives here:

~/.artemis/
├── workspace/
│   ├── SOUL.MD        
│   ├── OWNER.MD       
│   ├── MEMORY.MD      
│   └── TOOLS.MD       
├── skills/            # Installed SKILL.md files
├── scheduler.db       # SQLite scheduler database
└── memory.db          # ChromaDB vector store

SOUL.MD

TOOLS.MD

Structure

On this page