NousResearch/hermes-agent

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Local scripts

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Local scripts

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: airtable
- 3 description: Airtable REST API via curl. Records CRUD, filters, upserts.
- 4 version: 1.1.0
- 5 author: community
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 prerequisites:
- 9   env_vars: [AIRTABLE_API_KEY]
- 10   commands: [curl]
- 11 metadata:
- 12   hermes:
- 13     tags: [Airtable, Productivity, Database, API]
- 14     homepage: https://airtable.com/developers/web/api/introduction
- 15 ---
- 16 
- 17 # Airtable — Bases, Tables & Records
- 18 
- 19 Work with Airtable's REST API directly via `curl` using the `terminal` tool. No MCP server, no OAuth flow, no Python SDK — just `curl` and a personal access token.
- 20 
- 21 ## Prerequisites
- 22 
- 23 1. Create a **Personal Access Token (PAT)** at https://airtable.com/create/tokens (tokens start with `pat...`).
- 24 2. Grant these scopes (minimum):
- 25    - `data.records:read` — read rows
- 26    - `data.records:write` — create / update / delete rows
- 27    - `schema.bases:read` — list bases and tables

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: box
- 3 description: Box manages cloud files, sharing, search, and metadata.
- 4 version: 1.0.0
- 5 author: Chris Kim (iskysun96), Hermes Agent
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 prerequisites:
- 9   commands: [box]
- 10 metadata:
- 11   hermes:
- 12     tags: [Box, Productivity, Cloud Storage, Collaboration, Metadata, Content Extraction, CLI, SDK]
- 13     related_skills: [google-workspace]
- 14     homepage: https://developer.box.com/
- 15 ---
- 16 
- 17 # Box
- 18 
- 19 Use Box as the cloud file system for file operations, collaboration, metadata, and document work. Run operations with Hermes' `terminal` tool and use the Box CLI; use the SDK guide when building an application.
- 20 
- 21 ## When to Use
- 22 
- 23 - Organizing, uploading, versioning, moving, sharing, or collaborating on Box files and folders
- 24 - Searching Box content or existing metadata
- 25 - Asking questions about Box files, extracting metadata, or generating text grounded in a file
- 26 - Processing a Box folder at scale without downloading every source file
- 27 - Building a Box-backed application, integration, or webhook handler
- 28 
- 29 ## Start broad file-system conversations
- 30 
- 31 When someone is exploring a cloud file system for Hermes, first give a short fit assessment: Box is useful when a team needs cloud file storage, sharing, search, metadata, and document work. Then ask whether they want to connect a Box account with OAuth or build a Box-backed application or integration with an SDK.
- 32 
- 33 OAuth makes Hermes act as the Box account authorized in the browser. That account's Box permissions determine what Hermes can access. To give Hermes narrower access, authorize an account that is invited only to the required files, folders, or Hubs.
- 34 
- 35 Do not run setup, show a command cookbook, propose account plans or folder taxonomies, or load every reference for a broad exploratory question. Wait for the user's answer, then load only the relevant path. When a request already names a concrete outcome, skip this discovery step and handle that outcome directly.
- 36 
- 37 Start normal CLI work with the official Box CLI OAuth app. It covers ordinary content work and Box AI. Use a custom **User Authentication (OAuth 2.0)** Platform App only when the requested operation needs an additional OAuth scope, such as webhook management. This remains an OAuth flow; do not substitute a server-side or impersonation identity.
- 38 
- 39 ## Perform chosen setup interactively
- 40 
- 41 When a user selects an authentication path or asks Hermes to connect Box, perform the setup through `terminal`; do not turn the next response into instructions for the user to copy. Take the next safe action yourself, and pause only for an approval, browser sign-in, administrator action, or secret that Hermes cannot safely supply.
- 42 
- 43 - If `box` is missing, ask for any terminal approval required to install `@box/cli` under the current Hermes home at `tools/box-cli`; then verify it with the shell-appropriate command in [CLI guide](references/cli-guide.md). Do not attempt a global npm install, use `sudo`, change npm's global prefix, or change `PATH`.
- 44 - Before OAuth, ask: **“Is Hermes running on the same computer as the browser you will use to authorize Box, or on a remote host such as a VPS, container, or cloud VM?”** Use normal `box login` only for the same-computer path. Use `box login --code` only for the remote/headless path. Do not infer runtime topology from the operating system alone; read [OAuth setup](references/oauth-setup.md) after the user answers.
- 45 - Before starting browser authorization, state that Hermes will act as the Box account signed in there. If the user wants narrower access, they can authorize an account that is invited only to the required files, folders, or Hubs. Do not make that account an administrator to unlock an exceptional operation.
- 46 - If a custom OAuth Platform App is necessary, use the CLI's interactive Platform App flow. Ask the user to enter its client secret only in the local CLI prompt; never request it in chat, write it to Hermes configuration, or commit it.
- 47 - If an install, browser authorization, environment switch, or permission change needs approval, request that approval and resume the setup after it is granted. Do not replace the action with a command list.
- 48 
- 49 ## Start each task
- 50 
- 51 1. Confirm the CLI and current actor. Probe with `command -v box` on POSIX shells or `Get-Command box -ErrorAction SilentlyContinue` in PowerShell. If `box` is on `PATH`, use it. If Hermes installed the CLI under its current home, use the shell-appropriate verified runner in [CLI guide](references/cli-guide.md) in place of every leading `box`. Then run `box users:get me --json --fields id,name,login` with that runner.
- 52    If this succeeds, record the actor and continue. Do not ask about authentication again. Treat `folders:items 0` only as a listing of the actor's root; it is not proof that a shared file, folder, or Hub is inaccessible. For a known file or folder, verify its ID directly; for a Hub, use the Hubs discovery path in [Box Hubs](references/hubs.md).
- 53 2. If authentication is absent, ask to connect a Box account with OAuth, then ask whether Hermes and the authorization browser run on the same computer or on separate hosts. Read [OAuth setup](references/oauth-setup.md).
- 54 3. Read the relevant reference before operating. Use documented commands first; only run subcommand help when the request needs an option not covered by the reference or the installed CLI rejects the documented form.
- 55 
- 56 Examples labeled `bash` use POSIX continuation syntax. In PowerShell, run the Box command on one line or replace each trailing `\` with PowerShell's backtick continuation. Do not paste POSIX variable assignments into PowerShell.
- 57 
- 58 ## Extend the CLI without pausing
- 59 
- 60 When the Box CLI lacks a dedicated subcommand, use `box request` for the matching REST endpoint and continue the ordinary operation. Do not ask the user to choose merely because the implementation uses REST; it is the same Box task and preserves the configured CLI identity. Read [REST API fallback](references/rest-api.md) when the endpoint needs a request body or custom header.
- 61 
- 62 Ask before a delete, a collaboration/shared-link or permission change, an identity change, a broad or costly batch mutation, or when the target or scope is ambiguous. Otherwise perform the requested operation and verify it.
- 63 
- 64 ## Choose the right path
- 65 
- 66 | Need | Read |
- 67 | --- | --- |
- 68 | CLI conventions, environments, JSON, or REST escape hatch | [CLI guide](references/cli-guide.md) |
- 69 | Files, folders, versions, links, or collaborations | [Content workflows](references/content-workflows.md) |
- 70 | Search, metadata, Box AI, or AI units | [Search and AI](references/search-and-ai.md) |
- 71 | Curated large-scale Q&A or a reusable knowledge base | [Box Hubs](references/hubs.md) |
- 72 | Many files or a resumable batch | [Bulk operations](references/bulk-operations.md) |
- 73 | Application code or a Box SDK | [SDK development](references/sdk-development.md) |
- 74 | Webhooks or Events API | [Webhooks and events](references/webhooks-and-events.md) |
- 75 | CLI unavailable or a missing CLI operation | [REST API fallback](references/rest-api.md) |
- 76 | Auth, permissions, rate limits, or API errors | [Troubleshooting](references/troubleshooting.md) |
- 77 
- 78 ## Content handling policy
- 79 
- 80 For semantic analysis of Box-hosted content, prefer Box AI: it preserves Box permissions, processes source files through Box's governed AI integration, keeps source-file bodies out of Hermes' coding-model context, and scales document work without downloading every file. Do not criticize or block another workflow; use it when the user explicitly chooses it.
- 81 
- 82 Use existing Box metadata or metadata queries for deterministic lookups. Otherwise use Box AI:
- 83 
- 84 - `ai:ask` for Q&A, summaries, and comparisons
- 85 - `ai:extract-structured` for known fields or metadata templates
- 86 - `ai:extract` for flexible key-value extraction
- 87 - `ai:text-gen` for writing grounded in one Box file
- 88 
- 89 For Q&A over more than 25 files or a reusable curated knowledge base, prefer Box AI for Hubs. Discover an existing accessible Hub first; only create or populate one after the user approves the shared-resource change. If no Hub is available and the user does not want one created, narrow a one-off request with search or metadata. Do not use a Hub for metadata extraction or text generation. Read [Box Hubs](references/hubs.md).
- 90 
- 91 When the user asks to extract metadata from a Box file, treat it as a request to persist the result unless they ask for a preview. Use structured extraction with inline fields when the desired schema is known and freeform extraction when the fields are exploratory. Reuse a compatible existing enterprise template when one represents every requested field. Otherwise store flat scalar results in the built-in `global.properties` metadata instance, or upload a JSON sidecar beside the source file when the result contains nested objects, tables, or values that must retain their types. Read every write back and compare it with the intended result. Never silently substitute a file description, attach a partial or unrelated template, truncate fields, or discard fields.
- 92 
- 93 Do not create or change metadata templates. Box does not permit creation of global templates, and enterprise-template administration is outside Hermes' normal OAuth content workflow. If the user needs reusable typed enterprise metadata and no compatible template exists, explain that a Box Admin or authorized Co-Admin must create it separately, leave existing structured metadata unchanged, and report the persisted `global.properties` instance or JSON sidecar instead. Read [Search and AI](references/search-and-ai.md) for the complete extraction and writeback workflow.
- 94 
- 95 Before the first Box AI request, state that Box AI must be enabled, consumes AI units, and remains limited to the current actor's permissions; do not wait for acknowledgement. An AI response returned to Hermes can still contain sensitive information. Confirm only when a material batch's file scope or expected AI-unit use is ambiguous, or when the user has not explicitly requested that scale. See [Search and AI](references/search-and-ai.md).
- 96 
- 97 ## Operate safely
- 98 
- 99 - Prefer IDs to paths and verify the current actor before diagnosing a missing file.
- 100 - Use `--json` and `--fields` to keep output small. For mutations, inventory first, confirm ambiguous or large scope, then read back the result.
- 101 - Run ordered CLI mutations serially so progress and recovery are unambiguous. Use documented bulk input support or bounded SDK concurrency for scalable work.
- 102 - Do not create a shared link merely to provide navigation. Shared links change access and require explicit confirmation.
- 103 - Do not put secrets in chat, command output, source control, or logs.
- 104 
- 105 ## Report results
- 106 
- 107 For every individually reported Box item, include its ID and a clickable navigation link:
- 108 
- 109 - File: `https://app.box.com/file/<FILE_ID>`
- 110 - Folder: `https://app.box.com/folder/<FOLDER_ID>`
- 111 - Hub: `https://app.box.com/hubs/<HUB_ID>`
- 112 
- 113 For large batches, link the source and destination folders plus exceptions instead of listing hundreds of items. A human may not be able to open content that is only visible to the connected Box account; state that clearly. Include the actor and verification performed in every write summary.
- 114 
- 115 ## Verify
- 116 
- 117 After any write, fetch the file or folder with the same actor or list its parent and confirm the returned ID and name. For a metadata write, retrieve the metadata instance and compare every returned field with the intended value; an HTTP success alone is not verification. Report missing, normalized, or rejected values. For a disposable setup check, create a smoke folder, verify it, then delete it only if the user authorized cleanup.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

- 11     related_skills: [pdf, pdf, docx, notion]
+ 11     related_skills: [pdf, microsoft-office, notion]
- 16 Turn documents into cited facts and proposed actions. Extraction is not legal advice, and low-confidence OCR or ambiguous language must remain visible. The `pdf` / `pdf` / `docx` skills own extraction mechanics; this skill owns what happens to the extracted content.
+ 16 Turn documents into cited facts and proposed actions. Extraction is not legal advice, and low-confidence OCR or ambiguous language must remain visible. The `pdf` and `microsoft-office` skills own extraction mechanics; this skill owns what happens to the extracted content.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: docx
- 3 description: Create, read, edit, template, and review Word .docx files.
- 4 version: 1.1.0
- 5 author: Nous Research
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [word, docx, documents, office, templates, revisions, comments]
- 11     category: productivity
- 12     related_skills: [pdf, xlsx, powerpoint]
- 13 ---
- 14 
- 15 # Docx Skill
- 16 
- 17 Create, read, edit, and template Microsoft Word `.docx` files with
- 18 python-docx via small CLIs. It handles text, styles, lists, tables,
- 19 images, headers/footers, `{{token}}` templating, tracked changes
- 20 (list/accept/reject), comments (list/add/delete), TOC and page-number
- 21 fields, and package health checks. It does not render documents itself
- 22 (PDF needs LibreOffice — see Converting to PDF) or edit legacy `.doc`.
- 23 
- 24 ## When to Use
- 25 
- 26 - The user asks to generate a Word document (report, letter, contract).
- 27 - You need the text, outline, styles, or embedded images of a `.docx`.
- 28 - You must change an existing `.docx`: replace text, edit table cells,
- 29   insert/delete paragraphs, apply styles, merge fragmented runs.
- 30 - You have a `.docx` template with `{{placeholders}}` to fill from data.
- 31 - The document has tracked changes to review, accept, or reject.
- 32 - You need to read reviewers' comments, or add/delete comments.
- 33 - A `.docx` won't open or behaves oddly and you need corruption triage.
- 34 - The document needs a table of contents or "Page X of Y" footers.
- 35 - Not for: `.doc` (legacy), `.odt`, or WYSIWYG layout work.
- 36 
- 37 ## Prerequisites
- 38 
- 39 - Python 3.10+ with `python-docx` installed:
- 40   `pip install python-docx` (import name is `docx`; lxml comes with it).
- 41 - Comments `add` uses the native API on python-docx >= 1.2 and an XML
- 42   fallback on older versions — both are automatic.
- 43 - For image blocks: the image files must exist locally (PNG/JPEG).
- 44 
- 45 ## How to Run
- 46 
- 47 All helpers live in `scripts/` next to this file. Run them with the
- 48 `terminal` tool; each supports `--help` and prints JSON to stdout.
- 49 
- 50 ```bash
- 51 python scripts/docx_create.py spec.json out.docx
- 52 python scripts/docx_read.py out.docx --text
- 53 python scripts/docx_edit.py replace out.docx --find old --replace new
- 54 python scripts/docx_template.py tpl.docx values.json filled.docx
- 55 python scripts/docx_revisions.py list out.docx
- 56 python scripts/docx_comments.py list out.docx
- 57 python scripts/docx_validate.py out.docx
- 58 ```
- 59 
- 60 ## Quick Reference
- 61 
- 62 | Task | Command |
- 63 | --- | --- |
- 64 | Create from JSON spec | `docx_create.py spec.json out.docx` |
- 65 | Full text (body+tables+headers/footers) | `docx_read.py f.docx --text` |
- 66 | Heading outline + table shapes | `docx_read.py f.docx --structure` |
- 67 | Styles actually used | `docx_read.py f.docx --styles` |
- 68 | Extract embedded images | `docx_read.py f.docx --images outdir/` |
- 69 | Detect tracked changes/comments | `docx_read.py f.docx --revisions` |
- 70 | Find/replace (formatting kept) | `docx_edit.py replace f.docx --find A --replace B -o out.docx` |
- 71 | Set a table cell | `docx_edit.py set-cell f.docx --table 0 --row 1 --col 2 --text X` |
- 72 | Insert paragraph before index N | `docx_edit.py insert f.docx --index N --text X --style Normal` |
- 73 | Delete paragraph N | `docx_edit.py delete f.docx --index N` |
- 74 | Apply style to paragraph N | `docx_edit.py style f.docx --index N --style "Heading 1"` |
- 75 | Merge equal-format adjacent runs | `docx_edit.py normalize f.docx -o out.docx` |
- 76 | Insert TOC field before para N | `docx_edit.py toc f.docx --index N -o out.docx` |
- 77 | "Page X of Y" footer fields | `docx_edit.py page-numbers f.docx` |
- 78 | Fill `{{tokens}}` | `docx_template.py tpl.docx values.json out.docx --strict` |
- 79 | List revisions (id/author/date/text) | `docx_revisions.py list f.docx` |
- 80 | Accept / reject all revisions | `docx_revisions.py accept-all f.docx -o out.docx` (or `reject-all`) |
- 81 | Accept / reject one revision | `docx_revisions.py accept f.docx --id 3 -o out.docx` |
- 82 | List comments (+anchored text) | `docx_comments.py list f.docx` |
- 83 | Add comment anchored to text | `docx_comments.py add f.docx --target "phrase" --text "note" --author You` |
- 84 | Delete comment by id | `docx_comments.py delete f.docx --id 0` |
- 85 | Health-check the package | `docx_validate.py f.docx` (exit 1 on errors) |
- 86 
- 87 ## Procedure
- 88 
- 89 1. **Create.** Write a JSON spec with `write_file`, then run
- 90    `scripts/docx_create.py`. The spec supports: `page` (size + margins in
- 91    mm), `header`/`footer` strings, `footer_page_numbers` (adds a
- 92    "Page X of Y" field footer), `styles` (custom paragraph styles with
- 93    font, size, bold/italic, hex `color`), and `blocks` — `heading`
- 94    (level 1-9), `paragraph` (either `text` or a `runs` list where each run
- 95    may set `bold`/`italic`/`underline`), `bullet_list`, `numbered_list`,
- 96    `table` (`header` row rendered bold, `rows`, optional built-in table
- 97    `style` such as `Table Grid`), `image` (`path`, optional `width_mm`),
- 98    `toc` (Table of Contents field), and `page_break`. The full spec
- 99    format is documented at the top of `scripts/docx_create.py`.
- 100 2. **Read.** Use `scripts/docx_read.py` with exactly one mode flag.
- 101    `--text` returns body paragraphs, all table cell text, and
- 102    header/footer text as JSON. `--structure` returns the heading outline
- 103    plus paragraph/table/section counts. `--images DIR` copies every file
- 104    under `word/media/` out of the package.
- 105 3. **Edit.** Use `scripts/docx_edit.py`. `replace` walks body, tables
- 106    (nested included), headers and footers, and preserves run formatting;
- 107    add `--body-only` to skip headers/footers. Pass `-o out.docx` to keep
- 108    the original; omit it to edit in place. Paragraph indices for
- 109    `insert`/`delete`/`style`/`toc` refer to `--structure`/`--text` body
- 110    order. Run `normalize` first on documents that came out of heavy Word
- 111    editing — it merges adjacent runs with identical formatting so later
- 112    find-replace matches reliably.
- 113 4. **Review revisions.** `docx_revisions.py list` reports every `w:ins`
- 114    and `w:del` (id, author, date, affected text) anywhere in body,
- 115    tables, headers, or footers. `accept-all` / `reject-all` resolve them
- 116    in bulk; `accept`/`reject --id N` handles a single revision. Accept
- 117    keeps insertions and drops deleted text; reject does the reverse.
- 118 5. **Comments.** `docx_comments.py list` returns each comment's id,
- 119    author, date, body text, and the document text it is anchored to.
- 120    `add --target "some phrase"` anchors a new comment to the first

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → e8639fd4312e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: notion
- 3 description: "Notion API + ntn CLI: pages, databases, markdown, Workers."
- 4 version: 2.0.0
- 5 author: community
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 prerequisites:
- 9   env_vars: [NOTION_API_KEY]
- 10 metadata:
- 11   hermes:
- 12     tags: [Notion, Productivity, Notes, Database, API, CLI, Workers]
- 13     homepage: https://developers.notion.com
- 14 ---
- 15 
- 16 # Notion
- 17 
- 18 Talk to Notion two ways. Same integration token works for both — pick by what's available.
- 19 
- 20 ◆ **`ntn` CLI** — Notion's official CLI. Shorter syntax, one-line file uploads, required for Workers. macOS + Linux only as of May 2026 (Windows support "coming soon"). **Default when installed.**
- 21 ◆ **HTTP + curl** — works everywhere including Windows. **Default fallback** when `ntn` isn't installed.
- 22 
- 23 ## Setup
- 24 
- 25 ### 1. Get an integration token (required for both paths)
- 26 
- 27 1. Create an integration at https://notion.so/my-integrations
- 28 2. Copy the API key (starts with `ntn_` or `secret_`)
- 29 3. Store in `${HERMES_HOME:-~/.hermes}/.env`:
- 30    ```
- 31 [credential-like text hidden]
- 32    ```
- 33 4. **Share target pages/databases with the integration** in Notion: page menu `...` → `Connect to` → your integration name. Without this, the API returns 404 for that page even though it exists.
- 34 
- 35 ### 2. Install `ntn` (preferred path on macOS / Linux)
- 36 
- 37 ```bash
- 38 # Recommended
- 39 curl -fsSL https://ntn.dev | bash
- 40 
- 41 # Or via npm (needs Node 22+, npm 10+)
- 42 npm install --global ntn
- 43 
- 44 ntn --version    # verify
- 45 ```
- 46 
- 47 **Skip `ntn login` — use the integration token instead.** This works headlessly, no browser needed:
- 48 ```bash
- 49 [credential-like text hidden]
- 50 export NOTION_KEYRING=0                       # don't try to use the OS keychain
- 51 ```
- 52 
- 53 Add those exports to your shell profile (or to `${HERMES_HOME:-~/.hermes}/.env`) so every session inherits them.
- 54 
- 55 ### 3. Choose path at runtime
- 56 
- 57 ```bash
- 58 if command -v ntn >/dev/null 2>&1; then
- 59   # use ntn
- 60 else
- 61   # fall back to curl
- 62 fi
- 63 ```
- 64 
- 65 Windows users: skip step 2 entirely until native `ntn` ships — Path B works fine. If you want CLI ergonomics now, install `ntn` inside WSL2.
- 66 
- 67 ## API Basics
- 68 
- 69 `Notion-Version: 2025-09-03` is required on all HTTP requests. `ntn` handles this for you. In this version, what users call "databases" are called **data sources** in the API.
- 70 
- 71 ## Path A — `ntn` CLI (preferred, macOS / Linux)
- 72 
- 73 ### Raw API calls (shorthand for curl)
- 74 ```bash
- 75 ntn api v1/users                                  # GET
- 76 # POST with inline body
- 77 ntn api v1/pages parent[page_id]=abc123 \
- 78   properties[title][0][text][content]="Notes"
- 79 ntn api v1/pages/abc123 -X PATCH archived:=true   # PATCH; := is non-string (bool/num/null)
- 80 ```
- 81 
- 82 Syntax notes:
- 83 - `key=value` — string fields
- 84 - `key[nested]=value` — nested object fields
- 85 - `key:=value` — typed assignment (booleans, numbers, null, arrays)
- 86 
- 87 ### Search
- 88 ```bash
- 89 ntn api v1/search query="page title"
- 90 ```
- 91 
- 92 ### Read page metadata
- 93 ```bash
- 94 ntn api v1/pages/{page_id}
- 95 ```
- 96 
- 97 ### Read page as Markdown (agent-friendly)
- 98 ```bash
- 99 ntn api v1/pages/{page_id}/markdown
- 100 ```
- 101 
- 102 ### Read page content as blocks
- 103 ```bash
- 104 ntn api v1/blocks/{page_id}/children
- 105 ```
- 106 
- 107 ### Create page from Markdown
- 108 ```bash
- 109 ntn api v1/pages \
- 110   parent[page_id]=xxx \
- 111   properties[title][0][text][content]="Notes from meeting" \
- 112   markdown="# Agenda
- 113 
- 114 - Q3 roadmap
- 115 - Hiring"
- 116 ```
- 117 
- 118 ### Patch a page with Markdown
- 119 ```bash
- 120 ntn api v1/pages/{page_id}/markdown -X PATCH \

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

- 12     related_skills: [docx, xlsx, powerpoint]
+ 12     related_skills: [microsoft-office]
- 34 - Python 3.10+ with `pypdf`, `reportlab`, `pdfplumber`:
- 35   `python -m pip install pypdf reportlab pdfplumber`
- 36 - Optional, for page rasterization (`pdf_page_image.py`, overlay rendering): `python -m pip install pypdfium2`, or poppler's `pdftoppm` on PATH. Scripts fall back pypdfium2 → pdftoppm and report `{"rendered": false, "missing": [...]}` (exit 0) when neither exists.
+ 34 - Python 3.10+ with `pypdf`, `reportlab`, `pdfplumber`.
+ 35 - Pick the interpreter with `terminal`. Use `python` when it already imports
+ 36   the libraries (the Hermes Docker image ships them). Otherwise, when `hermes`
+ 37   is on PATH, let Hermes build its shared, pinned documents environment under
+ 38   the Hermes home: it survives container restarts, never touches the Hermes
+ 39   install itself, and is safe to run from several agents at once. When it is
+ 40   not (the terminal runs in a Docker sandbox, which has no Hermes), the block
+ 41   builds a venv in the sandbox home with the same pinned versions. Use this
+ 42   exact block in every document skill so they all share one environment:
+ 43 
+ 44   ```bash
+ 45   python -c "import pypdf, reportlab, pdfplumber" 2>/dev/null && PY=python || if command -v hermes >/dev/null 2>&1; then
+ 46     PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"
+ 47   else
+ 48     PY="$HOME/.cache/hermes-docs-venv/bin/python"
+ 49     "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (
+ 50       # Safe to run from several agents at once: each caller builds a private venv,
+ 51       # a symlink publishes the first finished one atomically, the others delete theirs;
+ 52       # a published build is replaced and deleted only while it still fails to import.
+ 53       mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1
+ 54       old="$(readlink hermes-docs-venv)"  # the published build, if any (another agent may have just published it)
+ 55       python3 -m venv "$stage" &&
+ 56         "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&
+ 57         "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&
+ 58         if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv
+ 59         elif [ "$(readlink hermes-docs-venv)" = "$old" ] && ! "$old/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null; then
+ 60           ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&
+ 61             case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac
+ 62         fi 2>/dev/null
+ 63       [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"
+ 64     )
+ 65   fi
+ 66   export PY
+ 67   "$PY" scripts/pdf_create.py --help
+ 68   ```
+ 69 
+ 70   Run every helper below with `"$PY"`. In PowerShell (Hermes runs on that
+ 71   host, so it is on PATH):
+ 72   `$env:PY = hermes pm environment documents --extra documents --extra documents-pdf`.
+ 73   Never `pip install` into the interpreter that runs Hermes or into the
+ 74   `hermes pm environment` one; Hermes owns both.
+ 75 - Page rasterization (`pdf_page_image.py`, overlay rendering) uses `pypdfium2`, which the documents environment already has (if your `python` lacks it, switch `PY` to that environment with the command above), or poppler's `pdftoppm` on PATH. Scripts fall back pypdfium2 → pdftoppm and report `{"rendered": false, "missing": [...]}` (exit 0) when neither exists.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: powerpoint
- 3 description: Create, read, edit .pptx decks with python-pptx.
- 4 version: 1.1.0
- 5 author: Nous Research
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [pptx, powerpoint, presentations, slides, office, python-pptx]
- 11     category: productivity
- 12     related_skills: [docx, xlsx, pdf]
- 13 ---
- 14 
- 15 # Powerpoint Skill
- 16 
- 17 Create, inspect, and edit PowerPoint (.pptx) presentations using the
- 18 python-pptx library. Five helper scripts cover deck creation from a JSON
- 19 spec, structured read-back, in-place edits, template-driven brand decks,
- 20 and slide rendering — all offline, no PowerPoint installation required.
- 21 
- 22 ## When to Use
- 23 
- 24 - The user asks to build a slide deck, report presentation, or pitch deck.
- 25 - You need to extract text, notes, tables, chart data, or images from a
- 26   .pptx someone shared.
- 27 - You need to update an existing deck: replace text, refresh or patch
- 28   chart data, swap a logo, duplicate/remove/reorder slides, set
- 29   backgrounds, footers, hyperlinks, or speaker notes.
- 30 - You must produce an on-brand deck from a company .pptx template.
- 31 - Do NOT use this for .ppt (legacy binary) files — convert them first with
- 32   `soffice --convert-to pptx old.ppt` if LibreOffice is available.
- 33 
- 34 ## Prerequisites
- 35 
- 36 - Python 3.10+ with `python-pptx` installed
- 37   (`pip install python-pptx`).
- 38 - Optional: LibreOffice (`soffice`) plus poppler (`pdftoppm` or
- 39   `pdftocairo`) for rendering slides to PNGs and for PDF export.
- 40   `pptx_render.py` detects both with `shutil.which` and degrades
- 41   gracefully (reports `{"rendered": false, "missing": [...]}`, exit 0)
- 42   when absent — all create/read/edit operations work without them.
- 43 - Check availability via `terminal`:
- 44   `python -c "import pptx; print(pptx.__version__)"` and `which soffice pdftoppm`.
- 45 
- 46 ## How to Run
- 47 
- 48 All scripts live in `scripts/`, take `--help`, print JSON to stdout, and
- 49 exit non-zero on failure. Run them with `terminal`:
- 50 
- 51 ```bash
- 52 python scripts/pptx_create.py deck.json out.pptx
- 53 python scripts/pptx_read.py deck.pptx --outline      # full JSON outline
- 54 python scripts/pptx_read.py deck.pptx --notes        # speaker notes
- 55 python scripts/pptx_read.py deck.pptx --images ./img # export pictures
- 56 python scripts/pptx_edit.py deck.pptx --replace-text "Old Corp" "New Corp"
- 57 python scripts/pptx_edit.py deck.pptx --chart-data update.json
- 58 python scripts/pptx_edit.py deck.pptx --duplicate-slide 2
- 59 python scripts/pptx_edit.py deck.pptx --remove-slide 3 --move-slide 2 0
- 60 python scripts/pptx_from_template.py brand.pptx out.pptx --values vals.json
- 61 python scripts/pptx_render.py deck.pptx --outdir ./render  # slide PNGs
- 62 ```
- 63 
- 64 Author JSON specs with `write_file`; inspect script output and generated
- 65 JSON with `read_file`.
- 66 
- 67 ## Quick Reference
- 68 
- 69 | Task | Command |
- 70 |---|---|
- 71 | New deck from spec | `pptx_create.py spec.json out.pptx` |
- 72 | 16:9 vs 4:3 | `"slide_size": "16:9"` or `"4:3"` in the spec |
- 73 | Outline as JSON | `pptx_read.py deck.pptx --outline` |
- 74 | Export images | `pptx_read.py deck.pptx --images DIR` |
- 75 | Replace text | `pptx_edit.py deck.pptx --replace-text OLD NEW` |
- 76 | Replace chart data | `pptx_edit.py deck.pptx --chart-data spec.json` |
- 77 | Patch one series | same flag, spec with `"ops"` (see below) |
- 78 | Swap picture | `pptx_edit.py deck.pptx --swap-image N NAME new.png` |
- 79 | Duplicate slide | `pptx_edit.py deck.pptx --duplicate-slide N` |
- 80 | Remove slide | `pptx_edit.py deck.pptx --remove-slide N` |
- 81 | Reorder slide | `pptx_edit.py deck.pptx --move-slide FROM TO` |
- 82 | Slide background | `pptx_edit.py deck.pptx --set-background N RRGGBB` |
- 83 | Hyperlink runs | `pptx_edit.py deck.pptx --hyperlink N TEXT URL` |
- 84 | Slide number on | `pptx_edit.py deck.pptx --enable-slide-number N` |
- 85 | Footer text | `pptx_edit.py deck.pptx --set-footer N TEXT` |
- 86 | Set notes | `pptx_edit.py deck.pptx --set-notes N TEXT` |
- 87 | Append notes | `pptx_edit.py deck.pptx --append-notes N TEXT` |
- 88 | Fill template | `pptx_from_template.py tpl.pptx out.pptx --values v.json` |
- 89 | Render slide PNGs | `pptx_render.py deck.pptx --outdir DIR` |
- 90 
- 91 ## Procedure
- 92 
- 93 ### 1. Create a deck
- 94 
- 95 Write a JSON spec (see `pptx_create.py --help` for the full format), then
- 96 run `pptx_create.py`. Per slide you can set: `layout` (title,
- 97 title_content, section, two_content, title_only, blank), `title`,
- 98 `subtitle`, `bullets` (strings, or dicts with `level` 0-4, `size` pt,
- 99 `bold`, `italic`, `font`, `color` hex, `link` URL for a hyperlink),
- 100 `background` (solid hex), `footer` (text; enables the layout's footer
- 101 placeholder), `slide_number` (true; enables the layout's slide-number
- 102 placeholder), `images` (path + left/top/width/height in inches), `tables`
- 103 (`rows` as list-of-lists), `shapes` (rectangle, rounded_rectangle, oval,
- 104 diamond, right_arrow, chevron, with `fill` hex + optional `text`),
- 105 `charts` (bar, bar_h, line, pie with `categories` + `series`), and
- 106 `notes` (speaker notes).
- 107 
- 108 ### 2. Read a deck
- 109 
- 110 `pptx_read.py deck.pptx --outline` returns slide size, layout inventory,
- 111 and per slide: layout name, all shape texts, table cells, image inventory
- 112 (filename/ext/bytes), chart categories/series/values, and speaker notes.
- 113 Use `--images DIR` to dump embedded pictures to files, then
- 114 `vision_analyze` on any exported image if you need to see its content.
- 115 
- 116 ### 3. Edit a deck
- 117 
- 118 `pptx_edit.py` combines operations in one pass; use `--output` to keep the
- 119 original. Text replacement scans slide shapes, table cells, and notes.
- 120 Image swap retargets the picture's relationship id so position and size

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: xlsx
- 3 description: Create, read, edit Excel .xlsx workbooks and CSVs.
- 4 version: 1.1.0
- 5 author: Nous Research
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [excel, spreadsheet, xlsx, csv, openpyxl, productivity]
- 11     category: productivity
- 12     related_skills: [docx, pdf, powerpoint]
- 13 ---
- 14 
- 15 # Xlsx Skill
- 16 
- 17 Work with Excel .xlsx workbooks using Python and openpyxl: build styled
- 18 multi-sheet workbooks with formulas and charts, inspect or dump existing
- 19 files, edit cells and structure, and convert to/from CSV. All helper
- 20 scripts are argparse CLIs that print JSON and use explicit UTF-8 I/O.
- 21 
- 22 ## When to Use
- 23 
- 24 - Creating .xlsx reports: multiple sheets, number formats, styling,
- 25   merged cells, freeze panes, autofilter, conditional formatting,
- 26   charts, data-validation dropdowns, native Excel tables, defined
- 27   names, hyperlinks, cell notes, sheet protection.
- 28 - Reading a workbook: sheet inventory, dumping data as JSON or CSV,
- 29   listing formulas vs cached values, notes, defined names, tables.
- 30 - Editing existing files: set cells, append rows, insert/delete
- 31   rows/columns (reference-aware via `xlsx_restructure.py`),
- 32   copy/rename sheets, tables, names, notes, protection.
- 33 - Recalculating formulas headlessly via LibreOffice
- 34   (`xlsx_recalc.py`).
- 35 - CSV interop with type inference and non-UTF-8 encodings.
- 36 - Not for the legacy .xls binary format (use LibreOffice to convert
- 37   first: `soffice --headless --convert-to xlsx old.xls`).
- 38 
- 39 ## Prerequisites
- 40 
- 41 - Python 3.10+ with `openpyxl` (`pip install openpyxl`). No other
- 42   third-party packages are needed; everything else is stdlib.
- 43 - Optional: LibreOffice (`soffice`) for headless recalculation or
- 44   format conversion.
- 45 
- 46 ## How to Run
- 47 
- 48 Run the helper scripts with the `terminal` tool from this skill's
- 49 `scripts/` directory (every script supports `--help`):
- 50 
- 51 ```bash
- 52 python scripts/xlsx_create.py spec.json report.xlsx   # build from JSON spec
- 53 python scripts/xlsx_read.py report.xlsx --sheets      # inventory
- 54 python scripts/xlsx_read.py report.xlsx --json --sheet Data
- 55 python scripts/xlsx_read.py report.xlsx --formulas
- 56 python scripts/xlsx_edit.py report.xlsx --sheet Data --set B2=42 --recalc
- 57 python scripts/xlsx_restructure.py report.xlsx --sheet Data --insert-rows 3:2
- 58 python scripts/xlsx_recalc.py report.xlsx
- 59 python scripts/csv_to_xlsx.py data.csv out.xlsx --encoding utf-8
- 60 python scripts/xlsx_to_csv.py report.xlsx out.csv --sheet Data
- 61 ```
- 62 
- 63 Author the JSON spec with `write_file`, inspect script JSON output with
- 64 `read_file` or directly from stdout.
- 65 
- 66 ## Quick Reference
- 67 
- 68 | Task | Command |
- 69 |---|---|
- 70 | Create workbook from spec | `xlsx_create.py spec.json out.xlsx` |
- 71 | Sheet names + dimensions | `xlsx_read.py f.xlsx --sheets` |
- 72 | Dump sheet as JSON | `xlsx_read.py f.xlsx --json --sheet S` |
- 73 | Dump sheet as CSV | `xlsx_read.py f.xlsx --csv --out d.csv` |
- 74 | List formulas + cached values | `xlsx_read.py f.xlsx --formulas` |
- 75 | Set a cell / formula | `xlsx_edit.py f.xlsx --set "A1==SUM(B:B)"` |
- 76 | Append a row | `xlsx_edit.py f.xlsx --append '[1,"x",true]'` |
- 77 | Insert 2 rows, refs NOT shifted | `xlsx_edit.py f.xlsx --insert-rows 3:2` |
- 78 | Insert 2 rows, refs shifted | `xlsx_restructure.py f.xlsx --insert-rows 3:2` |
- 79 | Delete a column, refs shifted | `xlsx_restructure.py f.xlsx --delete-cols B` |
- 80 | Create a native table | `xlsx_edit.py f.xlsx --add-table Sales:A1:C9` |
- 81 | Append inside a table | `--table-append 'Sales=["West",5]'` |
- 82 | List tables | `xlsx_edit.py f.xlsx --list-tables` |
- 83 | Defined names | `--define-name "Rates='Data'!$B$2:$B$9"` / `--delete-name Rates` / `xlsx_read.py f.xlsx --names` |
- 84 | Hyperlink | `--hyperlink "A1=https://example.com|Docs"` |
- 85 | Cell note | `--note "B2=Check this|Reviewer"`; read via `xlsx_read.py f.xlsx --notes` |
- 86 | Protect sheet (see Pitfalls) | `--protect your-password --unlock B2:B9` |
- 87 | Recalculate via LibreOffice | `xlsx_recalc.py f.xlsx` |
- 88 | Copy / rename sheet | `--copy-sheet Src:New --rename-sheet Old:New` |
- 89 | Force recalc on open | `xlsx_edit.py f.xlsx --recalc` |
- 90 | CSV -> styled xlsx | `csv_to_xlsx.py in.csv out.xlsx` |
- 91 | xlsx -> CSV | `xlsx_to_csv.py f.xlsx out.csv --encoding utf-8` |
- 92 
- 93 ## Procedure
- 94 
- 95 1. **Create**: write a JSON spec (schema documented in
- 96    `xlsx_create.py --help` and its docstring). Each sheet supports
- 97    `rows` (scalars or styled cell objects), sparse `cells` overrides,
- 98    `column_widths`, `row_heights`, `merges`, `freeze_panes`,
- 99    `autofilter`, `conditional_formats` (cell_is rules and color
- 100    scales), `charts` (bar/line/pie from cell ranges),
- 101    `validations` (list dropdowns), `tables` (native Excel tables with
- 102    a style name), and `protection`. Workbook-level `defined_names`
- 103    maps names to refs. Cell objects also take `hyperlink` and `note`.
- 104    Typed values: JSON numbers/bools
- 105    pass through; dates use `{"value": "2026-01-31", "type": "date"}`.
- 106    Number formats are Excel format strings: currency `"$#,##0.00"`,
- 107    percent `"0.0%"`, date `"yyyy-mm-dd"`.
- 108 2. **Formulas**: set with `"formula": "SUM(B2:B9)"` in the spec or
- 109    `--set "C1==SUM(A:A)"` in the editor. When writing formulas, add
- 110    `"full_calc_on_load": true` (spec) or `--recalc` (editor); this sets
- 111    the workbook's `fullCalcOnLoad` flag so Excel/LibreOffice recompute
- 112    everything on open. openpyxl itself NEVER evaluates formulas.
- 113 3. **Read**: `--sheets` for inventory (names, dimensions, merged
- 114    ranges, chart count, tables, protection, defined names),
- 115    `--json`/`--csv` for data, `--formulas` to
- 116    pair each formula string with its cached result, `--notes` for
- 117    cell comments, `--names` for defined names. Cached results
- 118    exist only if the file was last saved by a real spreadsheet app;
- 119    files fresh from openpyxl return `null` there. To materialize
- 120    results headlessly run `xlsx_recalc.py file.xlsx` (uses

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: llm-wiki
- 3 description: "Karpathy's LLM Wiki: build/query interlinked markdown KB."
- 4 version: 2.1.0
- 5 author: Hermes Agent
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [wiki, knowledge-base, research, notes, markdown, rag-alternative]
- 11     category: research
- 12     related_skills: [obsidian, arxiv]
- 13 ---
- 14 
- 15 # Karpathy's LLM Wiki
- 16 
- 17 Build and maintain a persistent, compounding knowledge base as interlinked markdown files.
- 18 Based on [Andrej Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f).
- 19 
- 20 Unlike traditional RAG (which rediscovers knowledge from scratch per query), the wiki
- 21 compiles knowledge once and keeps it current. Cross-references are already there.
- 22 Contradictions have already been flagged. Synthesis reflects everything ingested.
- 23 
- 24 **Division of labor:** The human curates sources and directs analysis. The agent
- 25 summarizes, cross-references, files, and maintains consistency.
- 26 
- 27 ## When This Skill Activates
- 28 
- 29 Use this skill when the user:
- 30 - Asks to create, build, or start a wiki or knowledge base
- 31 - Asks to ingest, add, or process a source into their wiki
- 32 - Asks a question and an existing wiki is present at the configured path
- 33 - Asks to lint, audit, or health-check their wiki
- 34 - References their wiki, knowledge base, or "notes" in a research context
- 35 
- 36 ## Wiki Location
- 37 
- 38 **Location:** Set via `WIKI_PATH` environment variable (e.g. in `${HERMES_HOME:-~/.hermes}/.env`).
- 39 
- 40 If unset, defaults to `~/wiki`.
- 41 
- 42 ```bash
- 43 WIKI="${WIKI_PATH:-$HOME/wiki}"
- 44 ```
- 45 
- 46 The wiki is just a directory of markdown files — open it in Obsidian, VS Code, or
- 47 any editor. No database, no special tooling required.
- 48 
- 49 ## Architecture: Three Layers
- 50 
- 51 ```
- 52 wiki/
- 53 ├── SCHEMA.md           # Conventions, structure rules, domain config
- 54 ├── index.md            # Sectioned content catalog with one-line summaries
- 55 ├── log.md              # Chronological action log (append-only, rotated yearly)
- 56 ├── raw/                # Layer 1: Immutable source material
- 57 │   ├── articles/       # Web articles, clippings
- 58 │   ├── papers/         # PDFs, arxiv papers
- 59 │   ├── transcripts/    # Meeting notes, interviews
- 60 │   └── assets/         # Images, diagrams referenced by sources
- 61 ├── entities/           # Layer 2: Entity pages (people, orgs, products, models)
- 62 ├── concepts/           # Layer 2: Concept/topic pages
- 63 ├── comparisons/        # Layer 2: Side-by-side analyses
- 64 └── queries/            # Layer 2: Filed query results worth keeping
- 65 ```
- 66 
- 67 **Layer 1 — Raw Sources:** Immutable. The agent reads but never modifies these.
- 68 **Layer 2 — The Wiki:** Agent-owned markdown files. Created, updated, and
- 69 cross-referenced by the agent.
- 70 **Layer 3 — The Schema:** `SCHEMA.md` defines structure, conventions, and tag taxonomy.
- 71 
- 72 ## Resuming an Existing Wiki (CRITICAL — do this every session)
- 73 
- 74 When the user has an existing wiki, **always orient yourself before doing anything**:
- 75 
- 76 ① **Read `SCHEMA.md`** — understand the domain, conventions, and tag taxonomy.
- 77 ② **Read `index.md`** — learn what pages exist and their summaries.
- 78 ③ **Scan recent `log.md`** — read the last 20-30 entries to understand recent activity.
- 79 
- 80 ```bash
- 81 WIKI="${WIKI_PATH:-$HOME/wiki}"
- 82 # Orientation reads at session start
- 83 read_file "$WIKI/SCHEMA.md"
- 84 read_file "$WIKI/index.md"
- 85 read_file "$WIKI/log.md" offset=<last 30 lines>
- 86 ```
- 87 
- 88 Only after orientation should you ingest, query, or lint. This prevents:
- 89 - Creating duplicate pages for entities that already exist
- 90 - Missing cross-references to existing content
- 91 - Contradicting the schema's conventions
- 92 - Repeating work already logged
- 93 
- 94 For large wikis (100+ pages), also run a quick `search_files` for the topic
- 95 at hand before creating anything new.
- 96 
- 97 ## Initializing a New Wiki
- 98 
- 99 When the user asks to create or start a wiki:
- 100 
- 101 1. Determine the wiki path (from `$WIKI_PATH` env var, or ask the user; default `~/wiki`)
- 102 2. Create the directory structure above
- 103 3. Ask the user what domain the wiki covers — be specific
- 104 4. Write `SCHEMA.md` customized to the domain (see template below)
- 105 5. Write initial `index.md` with sectioned header
- 106 6. Write initial `log.md` with creation entry
- 107 7. Confirm the wiki is ready and suggest first sources to ingest
- 108 
- 109 ### SCHEMA.md Template
- 110 
- 111 Adapt to the user's domain. The schema constrains agent behavior and ensures consistency:
- 112 
- 113 ```markdown
- 114 # Wiki Schema
- 115 
- 116 ## Domain
- 117 [What this wiki covers — e.g., "AI/ML research", "personal health", "startup intelligence"]
- 118 
- 119 ## Conventions
- 120 - File names: lowercase, hyphens, no spaces (e.g., `transformer-architecture.md`)

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: hermes-agent-skill-authoring
- 3 description: "Author in-repo SKILL.md files: frontmatter and structure."
- 4 version: 2.0.0
- 5 author: Hermes Agent
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [skills, authoring, hermes-agent, conventions, skill-md]
- 11     related_skills: [requesting-code-review]
- 12 ---
- 13 
- 14 # Authoring Hermes-Agent Skills (in-repo)
- 15 
- 16 ## Overview
- 17 
- 18 There are two places a SKILL.md can live:
- 19 
- 20 1. **User-local:** `~/.hermes/skills/<maybe-category>/<name>/SKILL.md` — personal, not shared. Created via `skill_manage(action='create')`.
- 21 2. **In-repo (this skill is about this case):** `skills/<category>/<name>/SKILL.md` or `optional-skills/<category>/<name>/SKILL.md` inside the hermes-agent repo — committed, shipped with the package. Use `write_file` + `git add`. `skill_manage(action='create')` does NOT target this tree.
- 22 
- 23 In-repo skills must meet the repo's **hardline authoring standards** (see AGENTS.md, "Skill authoring standards (HARDLINE)" — that section is the source of truth; this skill is the operational walkthrough). Reviewers reject PRs that violate them, so meeting them up front is cheaper than a salvage pass later.
- 24 
- 25 ## When to Use
- 26 
- 27 - User asks you to add a skill "in this branch / repo / commit"
- 28 - You're committing a reusable workflow that should ship with hermes-agent
- 29 - You're editing an existing skill under `skills/` or `optional-skills/` (use `patch` for small edits, `write_file` for rewrites; `skill_manage` still works for patch on in-repo skills, but not for `create`)
- 30 - Don't use for: personal skills in `~/.hermes/skills/` (just use `skill_manage`)
- 31 
- 32 ## Decide the Tier First: Bundled vs Optional
- 33 
- 34 - **Bundled (`skills/<category>/`)** — daily-driver behavior, broadly useful across many user types, low footprint. Hard bar: you can say "a user will load this in 5+ sessions per month" with a straight face.
- 35 - **Optional (`optional-skills/<category>/`)** — niche, vertical-specific (blockchain, gaming, finance, one app), recurring-job/task skills, or anything heavy. Installed via `hermes skills install official/<category>/<skill>`.
- 36 
- 37 **When in doubt, optional.** Promoting later is easy; demoting is churn. "Would be useful to anyone who ever needs this" is an optional-tier argument, not a bundled one.
- 38 
- 39 Pick the category by what the tool IS, not what it feels like (an AI-agent CLI goes in `autonomous-ai-agents/` even if it "feels productivity"). Confirm existing categories with `search_files(pattern='*', target='files', path='skills')` and don't invent new top-level categories casually.
- 40 
- 41 **No router / index / hub skills.** A skill whose core content is a routing table pointing at sibling skills adds an indirection hop and duplicates the siblings' own `When to Use` triggers. If the skill would be empty without "load skill X instead" pointers, don't write it — the catalog and each sibling's triggers already do that job.
- 42 
- 43 ## Required Frontmatter
- 44 
- 45 Validator source of truth: `tools/skill_manager_tool.py::_validate_frontmatter`. Validator hard requirements:
- 46 
- 47 - Starts with `---` as the first bytes (no leading blank line).
- 48 - Closes with `\n---\n` before the body.
- 49 - Parses as a YAML mapping.
- 50 - `name` field present.
- 51 - `description` field present (validator ceiling 1024 chars — but see the repo hardline below, which is much stricter).
- 52 - Non-empty body after the closing `---`.
- 53 
- 54 Repo-standard shape (all fields expected, even where the validator doesn't enforce them):
- 55 
- 56 ```yaml
- 57 ---
- 58 name: my-skill-name               # lowercase, hyphens, ≤64 chars (MAX_NAME_LENGTH)
- 59 description: Concise capability statement, under sixty chars.
- 60 version: 0.1.0                    # semver; new skills start at 0.1.0
- 61 author: Real Name (github-handle), Hermes Agent
- 62 license: MIT
- 63 platforms: [linux, macos, windows]   # audit, don't guess — see Platform Gating
- 64 metadata:
- 65   hermes:
- 66     tags: [Short, Descriptive, Tags]
- 67     related_skills: [other-in-repo-skill]
- 68 ---
- 69 ```
- 70 
- 71 ### `description` rules (HARDLINE — the validator's 1024 is NOT the standard)
- 72 
- 73 - **≤ 60 characters.** One sentence. Ends with a period.
- 74 - State the capability, not the implementation, and don't repeat the skill name or its category name (the index prints the category above the skill).
- 75 - No marketing words ("powerful", "comprehensive", "seamless", "advanced").
- 76 - 60 is the width the system prompt skill index shows; `skill_manage` rejects a new or changed description over it, and the index clips a longer legacy one at a word boundary.
- 77 - If the description contains a `:`, wrap it in double quotes or YAML parses it as a mapping and the docs generator crashes. Quotes don't count toward the 60.
- 78 
- 79 Good: `Track named companies for material news with cited digests.`
- 80 Bad: `Use when a user asks to monitor named competitors or companies for product launches, pricing changes, funding, ...` (240 chars — rejected in review)
- 81 
- 82 ### `author` rules
- 83 
- 84 - Credit the **human first**, then "Hermes Agent" as secondary collaborator: `Ben Barclay (benbarclay), Hermes Agent`.
- 85 - Never `author: Hermes Agent` alone for contributed skills — credit the human, not the tool, even (especially) when an agent drafted the text.
- 86 - Maintainer-authored skills: `Teknium (teknium1), Hermes Agent`.
- 87 
- 88 ### `related_skills` rules
- 89 
- 90 - Every entry must resolve to an existing **in-repo** skill in the same tree state as your PR. Do not reference skills that were only planned, live in another PR, or exist only in `~/.hermes/skills/`.
- 91 - Verify each entry: `search_files(pattern='<name>', target='files', path='skills')` (and `optional-skills/`).
- 92 
- 93 ## Platform Gating: audit, don't trust
- 94 
- 95 `platforms:` gates loading by host OS. Set it from what the skill's prose and scripts actually invoke:
- 96 
- 97 | Skill uses only… | `platforms:` |
- 98 |---|---|
- 99 | Hermes tools + stdlib Python + cross-platform CLIs | `[linux, macos, windows]` |
- 100 | bash pipelines, `grep`/`awk`/`sed` chains, heredocs | `[linux, macos]` |
- 101 | `osascript`, `defaults`, `pmset` | `[macos]` |
- 102 | `apt`/`systemctl`/`/proc` | `[linux]` |
- 103 
- 104 <!-- no-tmp: ok — names the anti-pattern skill authors must avoid -->
- 105 POSIX-only signals to search for in `scripts/`: `fcntl`, `termios`, `pty`, `os.fork`, `os.killpg`, `signal.SIGKILL`, `os.kill(pid, 0)` liveness checks, hardcoded `/tmp` `/proc` `/etc`. Default posture: fix cross-platform first (`tempfile.gettempdir()`, `pathlib.Path`, `psutil.pid_exists`); gate narrower only when the dependency is genuinely platform-bound, and say why in `## Pitfalls`.
- 106 
- 107 ## Size Limits
- 108 
- 109 - Full SKILL.md: ≤ 100,000 chars enforced (`MAX_SKILL_CONTENT_CHARS`), but target **~100 lines for a simple skill, ~200 for a complex one**. Peer skills sit at 8-14k chars.
- 110 - Bulky or branch-specific material goes in `references/*.md`, `templates/`, or `scripts/` — pointed to from SKILL.md, not inlined.
- 111 - Don't expect the model to inline-write parsers or non-trivial logic every call — ship a helper script in `scripts/` and reference it by path.
- 112 
- 113 ## Body Structure (modern section order)
- 114 
- 115 ```
- 116 # <Skill> Skill
- 117 2-3 sentence intro: what it does, what it doesn't do, dependency stance.
- 118 
- 119 ## When to Use          — bulleted triggers (+ "Don't use for:" counter-triggers)
- 120 ## Prerequisites        — exact env vars, installs, API key sourcing

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: inspecting-hermes-desktop-dom
- 3 description: "Read the live Hermes desktop DOM/CSS over CDP."
- 4 version: 1.0.0
- 5 author: Hermes Agent
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [desktop, electron, cdp, dom, ui-verification, self-inspection]
- 11     related_skills: [node-inspect-debugger, systematic-debugging, dogfood]
- 12 ---
- 13 
- 14 # Inspecting the live Hermes desktop DOM
- 15 
- 16 ## Overview
- 17 
- 18 When you are developing `apps/desktop` and the user is running that same app
- 19 (`hgui` / `npm run dev`), you can read the **live rendered DOM** of the window
- 20 they are looking at — computed styles, geometry, which CSS rule actually won,
- 21 console output — instead of inferring it from `.tsx` and being wrong.
- 22 
- 23 Dev-server runs open a Chrome DevTools Protocol port on `127.0.0.1:9222`
- 24 automatically. The renderer is a Chromium page, so everything DevTools can read,
- 25 a script can read.
- 26 
- 27 **This does not replace looking at it.** CDP answers *factual* questions ("what
- 28 is the computed padding", "did this element render", "which selector matches").
- 29 It cannot tell you whether the result looks good. Colour balance, spacing feel,
- 30 and "is this ugly" still need the user's eyes or a screenshot. Answer facts with
- 31 CDP; hand aesthetics to the user.
- 32 
- 33 ## When to Use
- 34 
- 35 - Verifying a UI change actually took effect in the running app
- 36 - "Why is this element still X?" — find the winning rule before editing anything
- 37 - Locating a stable selector for a component you're about to change
- 38 - Checking a design token's computed value on a real node
- 39 - Reading renderer console errors the user mentions but can't copy out
- 40 
- 41 **Don't use for:** perf profiling or heap work (`node-inspect-debugger`,
- 42 `debugging-hermes-desktop`), or anything where the real question is "does this
- 43 look right".
- 44 
- 45 ## The port
- 46 
- 47 Open on `127.0.0.1:9222` for any dev-server run. Closed in exactly two cases
- 48 (`apps/desktop/electron/dev-cdp.ts`):
- 49 
- 50 - **packaged builds** — always, and no environment value overrides it;
- 51 - **no `HERMES_DESKTOP_DEV_SERVER`** — an unpackaged `electron .` against
- 52   `dist/` is how the packaged app gets smoke tested, so it behaves like one.
- 53 
- 54 `HERMES_DESKTOP_CDP_PORT` moves the port (`=9333`) or disables it (`=off`).
- 55 
- 56 Check before doing anything else:
- 57 
- 58 ```bash
- 59 curl -s --max-time 3 http://127.0.0.1:${HERMES_DESKTOP_CDP_PORT:-9222}/json/version
- 60 ```
- 61 
- 62 Empty → no port. Do not guess another port silently.
- 63 
- 64 **Never relaunch the user's app to get a port.** That destroys their session and
- 65 their state. Launch your own isolated instance instead (below).
- 66 
- 67 ## Reading the DOM
- 68 
- 69 `apps/desktop/scripts/eval.mjs` is the one-liner:
- 70 
- 71 ```bash
- 72 cd apps/desktop
- 73 node scripts/eval.mjs "document.querySelectorAll('[data-slot]').length"
- 74 ```
- 75 
- 76 For multi-step work use the shared client — it has target discovery and
- 77 promise-aware eval:
- 78 
- 79 ```js
- 80 import { CDP, SELECTORS } from './scripts/perf/lib/cdp.mjs'
- 81 
- 82 const cdp = await CDP.connect({ port: 9222, match: '5174' })
- 83 const out = await cdp.eval(`JSON.stringify({
- 84   radius: getComputedStyle(document.documentElement).getPropertyValue('--radius-scalar').trim(),
- 85   composer: !!document.querySelector('[data-slot="composer-rich-input"]')
- 86 })`)
- 87 cdp.close()
- 88 ```
- 89 
- 90 `SELECTORS` in `scripts/perf/lib/cdp.mjs` holds the stable `data-slot` hooks
- 91 (composer, thread viewport, assistant message, turn pair, profile rail). Prefer
- 92 them over inventing a `querySelector` — they are updated as a unit when
- 93 components move.
- 94 
- 95 ## The question this is best at: which rule won?
- 96 
- 97 Editing every call site because a style "isn't applying" is the classic waste.
- 98 Read the real node first:
- 99 
- 100 ```js
- 101 const el = document.querySelector('[data-slot="aui_assistant-message-root"] a')
- 102 JSON.stringify({
- 103   ownClasses: el.className,
- 104   weight: getComputedStyle(el).fontWeight,
- 105   parents: (() => {
- 106     const out = []
- 107     let n = el
- 108     while ((n = n.parentElement) && out.length < 6) out.push(n.className)
- 109     return out
- 110   })()
- 111 })
- 112 ```
- 113 
- 114 If the node carries no class of its own, the value is **inherited** — sweeping
- 115 call sites will not fix it, and you need the ancestor rule. A plugin stylesheet
- 116 (e.g. `@tailwindcss/typography`'s `prose a { font-weight: 500 }`) routinely beats
- 117 a utility class; override on the shared class, not at each usage.
- 118 
- 119 ## Your own isolated instance
- 120 

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: node-inspect-debugger
- 3 description: "Debug Node.js via --inspect + Chrome DevTools Protocol CLI."
- 4 version: 1.0.0
- 5 author: Hermes Agent
- 6 license: MIT
- 7 platforms: [linux, macos, windows]
- 8 metadata:
- 9   hermes:
- 10     tags: [debugging, nodejs, node-inspect, cdp, breakpoints, ui-tui]
- 11     related_skills: [systematic-debugging, python-debugpy]
- 12 ---
- 13 
- 14 # Node.js Inspect Debugger
- 15 
- 16 ## Overview
- 17 
- 18 When `console.log` isn't enough, drive Node's built-in V8 inspector programmatically from the terminal. You get real breakpoints, step in/over/out, call-stack walking, local/closure scope dumps, and arbitrary expression evaluation in the paused frame.
- 19 
- 20 Two tools, pick one:
- 21 
- 22 - **`node inspect`** — built-in, zero install, CLI REPL. Best for quick poking.
- 23 - **`ndb` / CDP via `chrome-remote-interface`** — scriptable from Node/Python; best when you want to automate many breakpoints, collect state across runs, or debug non-interactively from an agent loop.
- 24 
- 25 **Prefer `node inspect` first.** It's always available and the REPL is fast.
- 26 
- 27 ## When to Use
- 28 
- 29 - A Node test fails and you need to see intermediate state
- 30 - ui-tui crashes or behaves wrong and you want to inspect React/Ink state pre-render
- 31 - tui_gateway child processes (`_SlashWorker`, PTY bridge workers) misbehave
- 32 - You need to inspect a value in a closure that `console.log` can't reach without patching
- 33 - Perf: attach to a running process to capture a CPU profile or heap snapshot
- 34 
- 35 **Don't use for:** things `console.log` solves in under a minute. Breakpoint-driven debugging is heavier; use it when the payoff is real.
- 36 
- 37 ## Quick Reference: `node inspect` REPL
- 38 
- 39 Launch paused on first line:
- 40 
- 41 ```bash
- 42 node inspect path/to/script.js
- 43 # or with tsx
- 44 node --inspect-brk $(which tsx) path/to/script.ts
- 45 ```
- 46 
- 47 The `debug>` prompt accepts:
- 48 
- 49 | Command | Action |
- 50 |---|---|
- 51 | `c` or `cont` | continue |
- 52 | `n` or `next` | step over |
- 53 | `s` or `step` | step into |
- 54 | `o` or `out` | step out |
- 55 | `pause` | pause running code |
- 56 | `sb('file.js', 42)` | set breakpoint at file.js line 42 |
- 57 | `sb(42)` | set breakpoint at line 42 of current file |
- 58 | `sb('functionName')` | break when function is called |
- 59 | `cb('file.js', 42)` | clear breakpoint |
- 60 | `breakpoints` | list all breakpoints |
- 61 | `bt` | backtrace (call stack) |
- 62 | `list(5)` | show 5 lines of source around current position |
- 63 | `watch('expr')` | evaluate expr on every pause |
- 64 | `watchers` | show watched expressions |
- 65 | `repl` | drop into REPL in current scope (Ctrl+C to exit REPL) |
- 66 | `exec expr` | evaluate expression once |
- 67 | `restart` | restart script |
- 68 | `kill` | kill the script |
- 69 | `.exit` | quit debugger |
- 70 
- 71 **In the `repl` sub-mode:** type any JS expression, including access to locals/closure variables. `Ctrl+C` exits back to `debug>`.
- 72 
- 73 ## Attaching to a Running Process
- 74 
- 75 When the process is already running (e.g. a long-lived dev server or the TUI gateway):
- 76 
- 77 ```bash
- 78 # 1. Send SIGUSR1 to enable the inspector on an existing process
- 79 kill -SIGUSR1 <pid>
- 80 # Node prints: Debugger listening on ws://127.0.0.1:9229/<uuid>
- 81 
- 82 # 2. Attach the debugger CLI
- 83 node inspect -p <pid>
- 84 # or by URL
- 85 node inspect ws://127.0.0.1:9229/<uuid>
- 86 ```
- 87 
- 88 To start a process with the inspector from the beginning:
- 89 
- 90 ```bash
- 91 node --inspect script.js           # listen on 127.0.0.1:9229, keep running
- 92 node --inspect-brk script.js       # listen AND pause on first line
- 93 node --inspect=0.0.0.0:9230 script.js   # custom host:port
- 94 ```
- 95 
- 96 For TypeScript via tsx:
- 97 
- 98 ```bash
- 99 node --inspect-brk --import tsx script.ts
- 100 # or older tsx
- 101 node --inspect-brk -r tsx/cjs script.ts
- 102 ```
- 103 
- 104 ## Programmatic CDP (scripting from terminal)
- 105 
- 106 When you want to automate — set many breakpoints, capture scope state, script a repro — use `chrome-remote-interface`:
- 107 
- 108 ```bash
- 109 npm i -g chrome-remote-interface        # or project-local
- 110 # Start your target:
- 111 node --inspect-brk=9229 target.js &
- 112 ```
- 113 
- 114 Driver script (save as `~/.hermes/cache/scratch/cdp-debug.js`):
- 115 
- 116 ```javascript
- 117 const CDP = require('chrome-remote-interface');
- 118 
- 119 (async () => {
- 120   const client = await CDP({ port: 9229 });

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Not checked yet

0b8bf3bdab6e → e8639fd4312e

SKILL.md was removed.

- 1 ---
- 2 name: python-debugpy
- 3 description: "Debug Python: pdb REPL + debugpy remote (DAP)."
- 4 version: 1.0.0
- 5 author: Hermes Agent
- 6 license: MIT
- 7 platforms: [linux, macos]
- 8 metadata:
- 9   hermes:
- 10     tags: [debugging, python, pdb, debugpy, breakpoints, dap, post-mortem]
- 11     related_skills: [systematic-debugging, node-inspect-debugger]
- 12 ---
- 13 
- 14 # Python Debugger (pdb + debugpy)
- 15 
- 16 ## Overview
- 17 
- 18 Three tools, picked by situation:
- 19 
- 20 | Tool | When |
- 21 |---|---|
- 22 | **`breakpoint()` + pdb** | Local, interactive, simplest. Add `breakpoint()` in the source, run normally, get a REPL at that line. |
- 23 | **`python -m pdb`** | Launch an existing script under pdb with no source edits. Useful for quick poking. |
- 24 | **`debugpy`** | Remote / headless / "attach to already-running process." Talks DAP, scriptable from terminal, works for long-lived processes (gateway, daemon, PTY children). |
- 25 
- 26 **Start with `breakpoint()`.** It's the cheapest thing that works.
- 27 
- 28 ## When to Use
- 29 
- 30 - A test fails and the traceback doesn't reveal why a value is wrong
- 31 - You need to step through a function and watch a collection mutate
- 32 - A long-running process (hermes gateway, tui_gateway) misbehaves and you can't restart it
- 33 - Post-mortem: an exception fired in prod-ish code and you want to inspect locals at the crash site
- 34 - A subprocess / child (Python `_SlashWorker`, PTY bridge worker) is the actual bug site
- 35 
- 36 **Don't use for:** things `print()` / `logging.debug` solve in under a minute, or things `pytest -vv --tb=long --showlocals` already reveals.
- 37 
- 38 ## pdb Quick Reference
- 39 
- 40 Inside any pdb prompt (`(Pdb)`):
- 41 
- 42 | Command | Action |
- 43 |---|---|
- 44 | `h` / `h cmd` | help |
- 45 | `n` | next line (step over) |
- 46 | `s` | step into |
- 47 | `r` | return from current function |
- 48 | `c` | continue |
- 49 | `unt N` | continue until line N |
- 50 | `j N` | jump to line N (same function only) |
- 51 | `l` / `ll` | list source around current line / full function |
- 52 | `w` | where (stack trace) |
- 53 | `u` / `d` | move up / down in the stack |
- 54 | `a` | print args of the current function |
- 55 | `p expr` / `pp expr` | print / pretty-print expression |
- 56 | `display expr` | auto-print expr on every stop |
- 57 | `b file:line` | set breakpoint |
- 58 | `b func` | break on function entry |
- 59 | `b file:line, cond` | conditional breakpoint |
- 60 | `cl N` | clear breakpoint N |
- 61 | `tbreak file:line` | one-shot breakpoint |
- 62 | `!stmt` | execute arbitrary Python (assignments included) |
- 63 | `interact` | drop into full Python REPL in current scope (Ctrl+D to exit) |
- 64 | `q` | quit |
- 65 
- 66 The `interact` command is the most powerful — you can import anything, inspect complex objects, even call methods that mutate state. Locals are read-only by default; use `!x = 42` from the `(Pdb)` prompt to mutate.
- 67 
- 68 ## Recipe 1: Local breakpoint
- 69 
- 70 Easiest. Edit the file:
- 71 
- 72 ```python
- 73 def compute(x, y):
- 74     result = some_helper(x)
- 75     breakpoint()           # <-- drops into pdb here
- 76     return result + y
- 77 ```
- 78 
- 79 Run the code normally. You land at the `breakpoint()` line with full access to locals.
- 80 
- 81 **Don't forget to remove `breakpoint()` before committing.** Use `git diff` or a pre-commit grep:
- 82 ```bash
- 83 rg -n 'breakpoint\(\)' --type py
- 84 ```
- 85 
- 86 ## Recipe 2: Launch a script under pdb (no source edits)
- 87 
- 88 ```bash
- 89 python -m pdb path/to/script.py arg1 arg2
- 90 # Lands at first line of script
- 91 (Pdb) b path/to/script.py:42
- 92 (Pdb) c
- 93 ```
- 94 
- 95 ## Recipe 3: Debug a pytest test
- 96 
- 97 Use `terminal` and the canonical runner for noninteractive diagnostics:
- 98 
- 99 ```bash
- 100 # Show locals in tracebacks without pdb:
- 101 scripts/run_tests.sh tests/path/to/test_file.py --showlocals --tb=long
- 102 ```
- 103 
- 104 `scripts/run_tests.sh` captures each file in a separate subprocess, so `--pdb`
- 105 or `--trace` cannot provide an interactive prompt there. For an interactive
- 106 debugger only, use the independent development/test interpreter prepared in
- 107 Recipe 5 (never a production generation):
- 108 
- 109 ```bash
- 110 .venv/bin/python -m pytest tests/foo_test.py::test_bar --pdb
- 111 ```
- 112 
- 113 This bypasses the hermetic-env guarantees — fine for debugging, but re-run under the wrapper to confirm before pushing.
- 114 
- 115 ## Recipe 4: Post-mortem on any exception
- 116 
- 117 ```python
- 118 import pdb, sys
- 119 try:
- 120     run_the_thing()

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0b8bf3bdab6e → e8639fd4312e

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0b8bf3bdab6e

No earlier version was observed for comparison.

Compare on GitHub