Agent skill

Loci

by codesstar in codesstar/loci

Memory Palace for AI — persistent structured memory, identity, and task management across every conversation.

MITAuto-check passedProductivity & Automation

Install Loci

skills CLI
$ npx skills add codesstar/loci --skill loci -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install codesstar/loci loci --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/codesstar/loci.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/openclaw/skill .claude/skills/loci && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
loci
GitHub stars
465
Token cost
~1k tokens
SKILL.md length
477 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Memory Palace for AI — persistent structured memory, identity, and task management across every conversation.

  • Works in 4 steps: Check if ~/.loci/brain-path exists →… → If not, check if ~/loci/plan.md exists → If neither exists → run Bootstrap below → …
  • Tasks that involve Task management
  • SKILL.md covers ⚠️ FIRST: Check if brain exists, Bootstrap (auto-install for…, First-Time Setup and Daily Use
  • Calls git

What it does

Loci is an agent skill from codesstar/loci. Memory Palace for AI — persistent structured memory, identity, and task management across every conversation.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Task management. The repository describes itself as: Memory Palace for AI — persistent memory, identity, and multi-project orchestration for Claude Code. The licence is MIT.

When your agent uses it

  • Tasks that involve Task management

Example prompts

  • “/loci”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Check if ~/.loci/brain-path exists → read the path inside → verify plan.md exists there
  2. If not, check if ~/loci/plan.md exists
  3. If neither exists → run Bootstrap below
  4. If found → read plan.md. If status: template → run First-Time Setup. If status: active → brain is ready, skip to Daily Use

What it can do on your machine

Read from SKILL.md and the folder at commit da9c8b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Loci loads about 1k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 477 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from codesstar/loci at commit da9c8b4, republished under its MIT licence (© codesstar). 477 words, ~1,047 tokens.

Download SKILL.mdSave it as .claude/skills/loci/SKILL.md (or your agent's skills folder).
name
loci
description
Memory Palace for AI — persistent structured memory, identity, and task management across every conversation.
version
0.2.0

Loci — Memory Palace for AI

⚠️ FIRST: Check if brain exists

Run this check before doing anything else:

  1. Check if ~/.loci/brain-path exists → read the path inside → verify plan.md exists there
  2. If not, check if ~/loci/plan.md exists
  3. If neither exists → run Bootstrap below
  4. If found → read plan.md. If status: template → run First-Time Setup. If status: active → brain is ready, skip to Daily Use

Bootstrap (auto-install for new users)

The user doesn't need to do anything. You handle it:

bash
# Clone Loci brain template
git clone --depth 1 https://github.com/codesstar/loci.git ~/loci

# Remove git remote (user's data stays private)
cd ~/loci && git remote remove origin

# Register brain location
mkdir -p ~/.loci
echo "$HOME/loci" > ~/.loci/brain-path

After cloning, run First-Time Setup below. Tell the user:

  • "我在帮你设置记忆系统,只需要回答几个问题。"

First-Time Setup

When plan.md has status: template:

  1. Detect the user's language from their messages. Ask in that language.
  2. Ask these questions (can ask all at once):
    • What's your name?
    • What do you do? (Developer / Designer / Creator / Student / Other)
    • What's your most important focus right now?
    • What hours do you usually work? (Morning / Daytime / Evening / Night owl / Irregular)
    • Preferred language? (English / 中文 / Mix)
  3. Generate initial files from answers:
    • me/identity.md — name, role, current season
    • plan.md — mission + focus as first goal (set status: active)
    • tasks/active.md — first task from their focus
  4. Done. Say: "Your brain is ready. From now on, I'll remember the important things."

Daily Use

Brain path: read from ~/.loci/brain-path, or default ~/loci/

At conversation start, read L1 files before responding:

  • plan.md — life direction
  • tasks/active.md — current tasks
  • tasks/daily/YYYY-MM-DD.md — today's plan (if exists)
  • inbox.md — recent items only
Distillation — what to save where
SignalDestination
New tasktasks/active.md
Decisiondecisions/YYYY-MM-DD-slug.md
Personal factme/identity.md
Insight / lessonme/learned.md
Goal changeplan.md
Vague thoughtinbox.md

Factual → save silently in background, DO NOT make it the focus of your reply Subjective (values, strategy) → ask user first

Show full SKILL.md (205 more words)Show less
Behavior
  1. Be a normal AI first, memory system second. When the user says something, RESPOND to it naturally (react, comment, ask follow-up, help). Saving to brain happens silently in background — never reply with just "记住了" or "已记录". The user should feel like talking to a smart friend who happens to have perfect memory, not a filing cabinet.
  2. Read brain files before answering questions about the user
  3. Distill conclusions, not raw conversations
  4. Archive, never delete
  5. Don't guess — ask if unsure
  6. Speak human — say "待办" not "inbox", never expose file paths
  7. MEMORY.md and brain/ coexist — don't move content between them unless asked
Context Layers
LayerLoad whenContents
L1Every conversationplan.md, active.md, today's daily, inbox (7 items)
L2On demandme/ files, decisions, people
L3Never autoOld journals, archive, evolution.md

When working in a project with a .loci/ directory, read .loci/memory.md at conversation start. This file has 4 sections:

  • Story — 2-3 sentence project narrative
  • Current State — active info (< 7 days, auto-decays)
  • Established — durable knowledge (architecture, conventions, key decisions)
  • Patterns — recurring themes (AI auto-generated)

Save project knowledge to .loci/memory.md. Push cross-project decisions/milestones/insights to .loci/to-hq.md.

For detailed behavior rules, read docs/behavior.md in the brain directory.

© codesstar, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in integrations/openclaw/skill of codesstar/loci.

Open the folder on GitHubat commit da9c8b4

Compare with similar skills

Loci next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Loci compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Loci this skillcodesstar/loci465—~1kAutomated safety check: PassMIT
Superset Agent Standupsuperset-sh/superset15k—~712Automated safety check: PassCustom licence
AgentRQ Workspace Agentagentrq/agentrq1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Markdown Task Managerioniks/MarkdownTaskManager535—~2.2kAutomated safety check: PassMPL-2.0
Pi Messenger Crewnicobailon/pi-messenger719—~3.7kAutomated safety check: PassNone
Codekanban CLIfy0/CodeKanban225—~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Superset Agent Standup

    superset-sh/superset

    Sweeps every Superset workspace, task and agent terminal to report what finished, what needs review and what is blocked, read-only, and can publish the digest as a page.

    15k GitHub stars~712 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Guides a workspace agent through executing assigned tasks, replying to a remote human operator, and creating sub-tasks, memory and events inside an AgentRQ workspace.

    1.1k GitHub stars~1.9k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Markdown Task Manager

    ioniks/MarkdownTaskManager

    A skill your agent uses when managing tasks, the system is a Kanban task manager based on local Markdown files (kanban.md and archive.md).

    535 GitHub stars~2.2k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed
  • Pi Messenger Crew

    nicobailon/pi-messenger

    Orchestrator reference for pi-messenger Crew planning, task management, configuration, and agent coordination.

    719 GitHub stars~3.7k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Codekanban CLI

    fy0/CodeKanban

    Operate CodeKanban workflows, terminal sessions, and web sessions through the installable codekanban-cli command.

    225 GitHub stars~2.7k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Kanban Tui

    Zaloog/kanban-tui

    Comprehensive kanban board and task management via ktui CLI.

    285 GitHub stars~4.1k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

Questions about Loci

What does Loci do?

Memory Palace for AI — persistent structured memory, identity, and task management across every conversation. Loci is an agent skill from codesstar/loci. Memory Palace for AI — persistent structured memory, identity, and task management across every conversation.

When should I use Loci?

Loci fits situations like: tasks that involve Task management.

How do I install Loci in Claude Code?

Run `npx skills add codesstar/loci --skill loci -a claude-code`. Or copy the skill folder (integrations/openclaw/skill in codesstar/loci) into .claude/skills/loci in your project. Claude Code loads it when a task matches its description.

How do I install Loci in Codex?

Run `npx skills add codesstar/loci --skill loci -a codex`. Or copy the skill folder (integrations/openclaw/skill in codesstar/loci) into .agents/skills/loci in your project. Codex loads it when a task matches its description.

Can I use Loci in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add codesstar/loci --skill loci -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/loci, .gemini/skills/loci, .github/skills/loci and .opencode/skills/loci in your project.

What does Loci need to run?

Going by SKILL.md and its folder, Loci needs the command-line tools its instructions call (git).

Does Loci access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Loci safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Loci use?

Loci is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Loci use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Loci?

Skills that share tags, products or a category with Loci: Superset Agent Standup (superset-sh/superset, 15k stars), AgentRQ Workspace Agent (agentrq/agentrq, 1.1k stars), Markdown Task Manager (ioniks/MarkdownTaskManager, 535 stars) and Pi Messenger Crew (nicobailon/pi-messenger, 719 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Loci?

codesstar (a GitHub user) maintains it in codesstar/loci, which has 465 GitHub stars. The repository was last updated on September 3, 2026.

Source: codesstar/loci on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.