ai-assistant-workspace skill
Personal assistant kit for Claude Code, Codex CLI and Grok CLI: file-based memory, 23 skills and a guided first-run setup
- 137 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Writes notes, diary and memory to files on disk in plain text
- Notion, Google Workspace, Discord and Slack integrations access accounts if you set keys
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/ai-assistant-workspaceDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Writes notes, diary and memory to files on disk in plain text
- Notion, Google Workspace, Discord and Slack integrations access accounts if you set keys
This is third-party code. Review the repository files before installing.
What it does
ai-assistant-workspace turns a coding agent into a persistent personal assistant. Memory lives in files: AGENTS.md sets behavior and safety rules, MEMORY.md holds long-term notes about projects and preferences, memory/YYYYMMDD.md keeps the day log and notes/ collects research, plans and a diary. A new session picks up context from the files, so the entry tool does not matter. The skills/ directory holds 23 skills with the xs- prefix: diary, notes, calendar, health advisor, code review, development workflow, GitHub repository analysis, Notion, Google Workspace, arXiv, podcasts and YouTube notes, diagrams, Marp slides, transcription and creating your own skills. The xs-multi-agent skill detects installed CLIs such as Codex, Claude, Grok, Cursor and Antigravity and sends the question only to the available ones. On first launch the agent runs a dialogue from BOOTSTRAP.md and sets up the profile. The .claude/skills, .agents/skills and .grok/skills directories point to one skills/, so the kit works in all three tools. The recommended path is the xangi chat assistant, but running claude or codex directly in the clone is enough.
Who it is for. People who want to run a diary, notes and workflows through a coding agent without losing context between sessions.
Good fit when
- You need a long agent memory between sessions without a database: plain files
- You want notes, a diary and a day log through ordinary requests
- You want a fresh digest of tech news and arXiv papers on your topics
- One question should go to several CLI agents at once and the answers compared
- You need your own skills: xs-skill-creator helps write them
Not a fit when
- You need an isolated workspace for one project: the kit is built for a personal assistant
- You need standalone skills without memory files: the kit is built around them
- You do not read Japanese: part of the README and instructions is in Japanese
- Sensitive data must not go into logs: the agent writes notes to disk as plain text
Example request
Write today's work summary into the diary and note in MEMORY.md that the project moved to PostgreSQLLimitations
- One of the tools is required: Claude Code, Codex CLI or Grok CLI. Chat mode needs xangi.
- Notion, Google Workspace, Discord and Slack integrations work only if you set API keys or bot tokens.
- The documentation and skills are largely in Japanese.
- You do not need all 23 skills: the author advises keeping the necessary ones and removing the rest. BOOTSTRAP.md is deleted after setup.
How to disable. Delete the repository clone. The memory files MEMORY.md, memory/ and notes/ live inside it, so save them beforehand if you need them.
FAQ
How do I run ai-assistant-workspace without xangi?
Clone with git clone https://github.com/karaage0703/ai-assistant-workspace, enter the folder and run claude or codex. The first launch opens the BOOTSTRAP.md dialogue.
What is stored in MEMORY.md and memory/?
MEMORY.md holds long-term notes: projects, preferences, environment notes. memory/YYYYMMDD.md holds the day log and decisions.
Which tools does the kit support?
Claude Code, Codex CLI and Grok CLI: each has its own directory (.claude/skills, .agents/skills, .grok/skills), all pointing to a shared skills/.
How does xs-multi-agent work?
On every run the skill detects installed CLIs such as Codex, Claude, Grok, Cursor and Antigravity and sends one question only to the available ones. Agreement counts once at least two answers from different providers exist.
Do all skills need keys?
No. Notion, Google Workspace, Discord and Slack need keys or tokens, and the other skills work without external accounts.
Discussion
No questions or reviews yet.
Related
SkillsSet up Claude Code and Codex in one conversation: global instructions, rules, plugins, skills, a status line and correction memory
Local AI commands for voice and text: clipboard dictation, text fixes, speech, an assistant and parallel agents in worktrees
A workspace with AGENTS.md and 49 skills for product managers: backlog, goals, priorities, PRDs and verified execution
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
Open-source personal AI OS blueprint for Claude Code and Codex: context, second brain, daily briefs and drafts in your voice.
A library of 229 skills for work and life: sales, marketing, finance, engineering, design and parallel agent runs
README in short
The Japanese README presents the kit as a starter for a personal assistant and lists what it can do. Then it explains file memory, skills, cross-checking several agents, searching past context, quick start through xangi and directly, the directory layout and usage tips.