operations / agent
Shockwave
A notes app with a built-in AI agent that works on your workspace, syncs through GitHub and runs scheduled tasks on a server you own.
At a glance
- Purpose
- A notes app with a built-in AI agent that works on your workspace, syncs through GitHub and runs scheduled tasks on a server you own.
- Runs in
- Web service
- Operating systems
- macOS, Linux, Windows
- Needs
- Runtime: Not stated; Needs internet: Yes; Needs accounts or API keys beyond your agent: Yes
- Files and data
- Reads files: Yes; Writes files: Yes; Sends data to other services: Yes
- Tool type
- Agent
- Delivery
- From GitHub
- Version
- Latest on the main branch
- Access
- Code on GitHub
- Compatibility
- According to the README: downloads for macOS (Apple Silicon), Windows and Linux (an AppImage), a server on a Linux VPS, sync through GitHub, and the agent reachable through Telegram. You choose the model provider on the Agent Chat settings page, and the README names none.
- External costs
- According to the README, you need a small Linux server you own (any cheap Linux VPS will do), a GitHub token (which the README says is what makes syncing free) and a model provider with that provider's API key. The README states no prices. The server host and the model provider you connect may charge for usage.
- Permissions
- The README installs the server by downloading a script and piping it to sh. The README says the app updates that server and its containers restart themselves. The README requires the server API key, a GitHub token for sync and a model-provider API key. The README says messaging the Telegram bot makes the agent work on your workspace and push what it changed. The README says the bot is restricted to your Telegram user ID, accepts voice notes, photos and documents, and sends files back. The README says scheduled prompts run on the server in fresh chats and schedules are stored in the workspace's cron.json. The README does not describe approval or sandbox modes.
- Usage terms
- MIT License, as stated in the repository. See its LICENSE file for the exact terms.
- Interface
- desktop
Code on GitHub
stephengpope/shockwave
MITA local, file-based notes app where your work stays as plain .md files in a folder you own. It ships with a real coding agent baked right in (no separate Claude Code), and syncs through your own GitHub repo for free.
Public GitHub data fetched · 0 days old
Skill folders in this repository (5)
Folders that contain a SKILL.md file, from GitHub's file list on .
What it does
Shockwave is a notes app with an AI agent. The README describes desktop downloads for macOS, Windows and Linux connected to a server you run. The README says notes, keys and chats live on that server and scheduled work continues there when the laptop is shut. The GitHub description describes plain .md files in a folder you own.The README lists knowledge-base organization, memory and self-improvement, GitHub sync, schedules stored in cron.json, and a Telegram bot that works on the workspace. The README says the bot accepts voice notes, photos and documents and can send files back.
The README addresses non-technical note-takers and gives setup steps for downloading the app, running a server installer, and configuring Companion, GitHub Sync and Agent Chat.
Who it is for
Note-takers who want an AI agent working on their notes; the README addresses non-technical note-takers.Example tasks
Download the app and start your own server with the install script.Fill in the Companion, GitHub Sync and Agent Chat settings pages.
Ask the agent to review yesterday's notes every morning and update TODO.md.
Ask the agent for a reminder at a set time.
Create a Telegram bot and add its token and your user id in Settings.