DEV Community

albert nahas
albert nahas

Posted on

Meet Aissist - your personal AI command line sidekick

#programming #ai #career #productivity

Aissist Demo

Connect your past, present, and future — all in Markdown.

Most AI tools live in the cloud, detached from your workflow. Aissist flips that idea on its head.

It’s a local-first, AI-powered CLI personal assistant that helps you track what you’ve done, manage what you’re doing, and plan where you’re going — all through simple, human-readable Markdown files right on your machine.

No dashboards. No tabs. Just your terminal, your thoughts, and AI that actually understands your context.

✨ Why Aissist Exists

If you’re like most builders, your ideas, notes, and todos are scattered — in Notion, sticky notes, your brain, and a dozen text files. Aissist gives you one home for all of it, with the speed and focus of the terminal you already love.

It doesn’t just store information — it connects it.

Your past logs fuel insights for your next actions. Your goals inform your todos. Your reflections sharpen your focus.

Every command builds a timeline of your personal growth.

🧩 Core Features

  • 🔍 Claude Code Integration – Seamlessly connects with Anthropic’s Claude Code for AI-powered recall, summaries, and proposals.
  • 🕰️ Unified Timeline – Track your past (history), manage your present (todo), and plan your future (goal), all linked together.
  • 📂 Local-First & Markdown – Every memory lives in plain Markdown, version-controllable and future-proof.
  • 🌍 Dual Storage – Choose between global (~/.aissist/) or project-specific (./.aissist/) memory.
  • 🎯 Goal Tracking – Add and manage goals with auto-generated codenames and deadlines.
  • ☑️ Todo Management – Quick task capture, interactive completion, and automatic history logging.
  • 📜 History Logging – Create a searchable timeline of your daily work and thoughts.
  • 🧠 Context Management – Keep separate “memory lanes” for work, fitness, diet, or any custom context.
  • 🪞 Guided Reflection – Prompts that help you pause, reflect, and grow.
  • ⚙️ Git-Compatible – Everything works beautifully with version control.
  • 🎉 Terminal Animations – Subtle animations to make finishing tasks just a little more satisfying.

⚡ Quick Start 

npm install -g aissist
aissist init
aissist goal add "Launch my side project"
aissist todo add "Write README"
aissist history log "Fixed auth bug in production"
aissist recall "What did I learn about React last week?"
Enter fullscreen mode Exit fullscreen mode

That’s it — you’re now tracking, recalling, and planning with your personal AI sidekick.

💡 What Makes It Different

Aissist isn’t another productivity app. It’s a mindset shift.

It respects your data, your privacy, and your process.

  • Local-first: Everything lives on your machine. No sync, no tracking.
  • Markdown-native: Your memories remain portable, readable, and future-proof.
  • AI-empowered: Claude Code understands your files semantically — meaning you can ask natural questions like “What were my biggest challenges this month?” and get real insights back.
  • Zero setup friction: Works right out of the box. Add Claude later to supercharge it.
  • Hackable by design: Extend with your own slash commands, integrate APIs, or automate workflows.

🧭 Example Workflow

Morning:

aissist goal add "Finish feature implementation"
aissist todo add "Review pull requests"
Enter fullscreen mode Exit fullscreen mode

Afternoon:

aissist history log "Implemented API endpoint for auth"
aissist context log work "Meeting notes on scalability"
Enter fullscreen mode Exit fullscreen mode

Evening:

aissist reflect
aissist propose "this week"
Enter fullscreen mode Exit fullscreen mode

Aissist ties it all together — your timeline becomes a story you can search, analyze, and learn from.

🧠 Powered by Claude Code

When connected with Claude Code, Aissist becomes context-aware.

It uses read-only tools (grep, read, glob) to semantically search your Markdown files — finding meaning, not just keywords.

Ask:

aissist recall "compare my progress last quarter to this one"
Enter fullscreen mode Exit fullscreen mode

and get back summaries that connect dots across your personal history — all without exposing your data online.

🔧 Built for Builders

Aissist was designed for developers, creators, and thinkers who live in the terminal — people who value control, simplicity, and speed over yet another web UI.

It’s perfect for:

  • Tracking learning goals and coding progress
  • Keeping a private, searchable “second brain”
  • Managing project-specific tasks with context awareness
  • Generating AI-driven reflections or weekly summaries
  • Building your own AI workflows locally

🔐 Privacy First

  • No servers. No telemetry. No tracking.
  • All data stays 100% on your machine.
  • Works offline.
  • Every file is yours — readable, portable, and versionable.

🛠️ For Developers 

git clone https://github.com/albertnahas/aissist.git
cd aissist
npm install
npm run build
Enter fullscreen mode Exit fullscreen mode

Aissist is open-source and ready for your pull requests.

Fork it, tweak it, make it yours.

🌟 Vision

Aissist is built on a simple belief:

AI shouldn’t replace your memory — it should extend it.

We already live in the future of context overload. Aissist helps you take control of it — to connect where you’ve been, where you are, and where you’re going.

🧑‍🚀 Join the Movement

  • Try it with: 
  npx aissist init
Enter fullscreen mode Exit fullscreen mode

Top comments (0)