explaingit

1lystore/awaek

Analysis updated 2026-06-24

13PythonAudience · vibe coderComplexity · 2/5Setup · moderate

TLDR

A Hermes Agent skill that pulls your X bookmarks into a local SQLite library so the chat agent can search them, draft posts, and build plans from them.

Mindmap

mindmap
  root((Awaek))
    Inputs
      X bookmarks via xurl
      Chat questions
    Outputs
      Topic answers
      Drafted posts
      30-day plans
    Use Cases
      Search saved posts
      Draft growth posts
      Build content plan
    Tech Stack
      Python
      SQLite
      Hermes Agent
      xurl
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search your X bookmarks locally for past posts on a topic like x402 or pricing

USE CASE 2

Turn launch-related bookmarks into a 30-day content plan from chat

USE CASE 3

Draft new posts in the voice of growth posts you previously saved

USE CASE 4

Keep a private, local index of saved posts with no cloud sync

What is it built with?

PythonSQLiteHermesxurl

How does it compare?

1lystore/awaekactashui/sjtu-ppt-template-skillalyunzhangu/supervideogenaratefactory
Stars131313
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity2/52/53/5
Audiencevibe coderresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Hermes Agent installed plus xurl authenticated against an X account that can read its own bookmarks.

In plain English

Awaek is a small skill for a chat assistant called Hermes Agent that lets you talk to your own saved X (formerly Twitter) bookmarks. The pitch in the README is that most people save good posts and then never use them again, so Awaek pulls those saves into a local searchable library that the chat agent can answer questions from, draft posts with, or use to put together plans. The sample interactions show the kind of thing you can ask. Examples include asking what your saved posts say about AI agents, finding a specific old bookmark about x402 payments, turning launch-related bookmarks into a 30-day plan, or drafting twenty new posts in the style of your saved growth posts. The README is direct that everything stays on your machine: there is no hosted backend, no cloud database, no pasted X secrets, and authentication to X is delegated to a separate tool called xurl. Installation is one line. Inside any Hermes chat (terminal, Telegram, Slack, Discord, or the Open Web client) you can say install Awaek from 1lystore/awaek/skills/awaek, or run hermes skills install with the same path from a terminal. Awaek needs Hermes Agent, Python 3, and xurl authenticated against an account that can read its own bookmarks. The README links to the official X Developers post that explains setting up xurl, and gives a one-line curl install for it. Once installed, Awaek sync pulls bookmarks down (up to 100 recent saved posts in the current version), stores them in a local SQLite database at ~/.hermes/awaek/data/awaek.db, categorizes them, and builds a local search index. After that you can ask things like Awaek, show my bookmark topics or Awaek, find my saved posts about pricing. Under the hood the README says it syncs via xurl, stores in SQLite, categorizes, and builds evidence packs that the Hermes Agent can cite when answering. The roadmap mentions improvements like smarter topic learning, better packing of evidence for large bookmark libraries, a sample mode that works without a real X setup, connectors to saved-content sources beyond X, and richer writing workflows. The repository topics list it under ai-agent and hermes-skill tags.

Copy-paste prompts

Prompt 1
Show me the install command for Awaek inside a Hermes terminal session
Prompt 2
Explain how to authenticate xurl against my X account so Awaek sync works
Prompt 3
Write a chat prompt that asks Awaek to find my saved posts about AI agents
Prompt 4
Draft a Python script that reads ~/.hermes/awaek/data/awaek.db and lists my top bookmark topics

Frequently asked questions

What is awaek?

A Hermes Agent skill that pulls your X bookmarks into a local SQLite library so the chat agent can search them, draft posts, and build plans from them.

What language is awaek written in?

Mainly Python. The stack also includes Python, SQLite, Hermes.

How hard is awaek to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is awaek for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.