Quickstart

First of all, thank you for trying Hackerman Text!

• Suggestions, please submit a feature request
• Bugs or other issues, please submit a bug report

Hackerman Text is free for personal or evaluation purposes (non-commercial). Commercial use requires a license.

We are 100% user-funded, so please consider purchasing a license to support continued development.

• Code completion
• Inline commands and code execution
• Custom-editor-commands

Code completion

Code completion can be triggered with Code Completion (or Cmd + K).

Ollama

Hackerman Text can run some FIM/next-edit models via Ollama for very fast and 100% local code completion.

You need to install Ollama, and download one of the recommended models (such as https://ollama.com/library/qwen2.5-coder).

Update your .hackerman config file (Right-Click or Cmd+Shift+P to open function explorer, select Open Config File):

[models]

-- ollama
-- recommended models: qwen2.5-coder:1.5b, qwen2.5-coder:7b, sweepai/sweep-next-edit:latest, nate/instinct:latest
code_completion                     ollama, qwen2.5-coder:1.5b

Mistral/ Inception

Mistral: Create an account and get your api key, see https://docs.mistral.ai/getting-started/quickstart.

Inception: Create an account and get your api key, see https://docs.inceptionlabs.ai/get-started/authentication.

Update your .hackerman config file (Right-Click or Cmd+Shift+P to open function explorer, select Open Config File):

-- cloud providers
code_completion                     mistral, codestral-latest, API_KEY
-- code_completion                     inception, mercury-coder, API_KEY

Inline commands and code execution

Hackerman Text support running shell commands and evaluating Python expressions in any allowed file. By default, allowed files are txt and md.

Inline commands can be triggered with Inline Commands (or Cmd + Shift + Return).

% echo 'hello'
hello

42**42
150130937545296572356771972164254457814047970568738777235893533016064

Org-mode

Hackerman Text support code execution in Org files.

This currently works with Python, Lua, JavaScript, and Hy.

def main(name):
    print(f"Welcome to Python in org-mode, { name }!")
main(name)

Moving cursor into this code block and running Inline Command (or Cmd + Shift + Return).

#+RESULTS: True
: Welcome to Python in org-mode, Michael!

Custom editor commands

This is an opt-in feature, you can enable in your .hackerman config file (Right-Click or Cmd+Shift+P to open function explorer, select Open Config File):

scripts_enabled                     true
allow_unsafe_scripts                false -- allow imports

Hackerman Text loads Python-functions from .../Application Support/Hackerman Text/.hackerman-scripts. You can provide a path to your own .hackerman-scripts-file if stored elsewhere.

path_to_scripts_file                -- path to external scripts file, requires restart