familiar

compose and invoke ai agent prompts from reusable conjurings and invocations.

ships with a standard set of conjurings and invocations, or bring your own (mine are very much wip).

installation

pip install familiar-cli

usage

usage: familiar [-h] [--version] [--debug] {conjure,invoke,list,lint} ...

conjure and invoke familiars

positional arguments:
  {conjure,invoke,list,lint}
    conjure             compose system instructions for an agent
    invoke              render an invocation and run the agent
    list                list available conjurings and invocations
    lint                lint conjurings and invocations

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --debug               show full traceback on error

conjure conjurings to create system instructions for an agent:

familiar conjure codex rust infra sec

save composed conjurings as a reusable subagent:

familiar conjure claude python sec --save-subagent
familiar conjure codex rust infra --save-subagent --subagent-name ship_ops

save an invocation as a reusable skill:

familiar invoke claude code-review --save-skill
familiar invoke codex refactor src/foo.py --save-skill --skill-name cleanup_refactor

invoke an action prompt:

familiar invoke codex bootstrap-rust myapp lib 1.78 mit

run in a separate git worktree to avoid interfering with local changes:

familiar invoke --worktree codex bootstrap-rust myapp lib

list available conjurings and invocations:

familiar list

lint conjurings and invocations, including local .familiar/ overrides:

familiar lint

customization

add your own conjurings and invocations by creating files in .familiar/ in your repo:

.familiar/
  conjurings/
    myprofile.md      # new conjuring
    rust.md           # override built-in
  invocations/
    my-task.md        # new invocation

local files take precedence over built-ins.

plugins

add new agents via plugins:

pip install familiar-gemini
familiar invoke gemini bootstrap-python myapp cli

see the plugin docs for creating your own.

placeholders

invocations support placeholders:

$1, $2, ... - positional arguments
$ARGUMENTS - all positional arguments joined
{{key}} - named arguments passed via --kv key=value

documentation

full docs at familiar.readthedocs.io.

license

mit

Development Status
- 3 - Alpha
Environment
- Console
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
Topic
- Software Development :: Code Generators

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

familiar_cli-0.6.1.tar.gz (51.6 kB view details)

Uploaded Sep 6, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

familiar_cli-0.6.1-py3-none-any.whl (46.9 kB view details)

Uploaded Sep 6, 2026 Python 3

File details

Details for the file familiar_cli-0.6.1.tar.gz.

File metadata

Download URL: familiar_cli-0.6.1.tar.gz
Upload date: Sep 6, 2026
Size: 51.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for familiar_cli-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`f8fada3ff9d599454853e6db8e0edff98ed4f339d4983c5e0c65c8915fdcbf37`
MD5	`c5827907828e1608c5cf42884f9ddebd`
BLAKE2b-256	`e66f22fc0e7a3cb21268f5a93180a9415510d6b317db1ec7b35f8c93d8269cee`

See more details on using hashes here.

Provenance

The following attestation bundles were made for familiar_cli-0.6.1.tar.gz:

Publisher: publish.yml on cyberwitchery/familiar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: familiar_cli-0.6.1.tar.gz
- Subject digest: f8fada3ff9d599454853e6db8e0edff98ed4f339d4983c5e0c65c8915fdcbf37
- Sigstore transparency entry: 2743243873
- Sigstore integration time: Sep 6, 2026
Source repository:
- Permalink: cyberwitchery/familiar@1bfddba167e0df432003e3512451c5878ae8ac2a
- Branch / Tag: refs/tags/v0.6.1
- Owner: https://github.com/cyberwitchery
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@1bfddba167e0df432003e3512451c5878ae8ac2a
- Trigger Event: push