Astra

Plugin System

Astra plugins extend shell functionality without requiring changes to the core shell.

Plugins can add commands, integrations, completion features, and developer utilities.

Plugin Directory

By default, Astra looks for plugins in:

~/.astra/plugins

This location can be changed in:

~/.astrarc

[plugins]

enabled = true
directory = "~/.astra/plugins"

Plugin Structure

A plugin should have its own directory:

~/.astra/plugins/

example-plugin/
├── plugin.toml
└── main

Plugin Manifest

Each plugin contains a manifest describing the plugin.

name = "example-plugin"
version = "1.0.0"
description = "Example Astra plugin"
author = "Developer"

Official Plugins

Future official plugins may include:

• Git utilities
• System information
• Development tools
• Container management
• Network utilities

Community Plugins

Community plugins will eventually be distributed through the Astra plugin registry.

Plugins should follow Astra's guidelines:

• Keep dependencies minimal
• Document installation steps
• Avoid modifying user data without permission
• Provide clear error messages

Plugin Development

Plugin APIs are currently under development.

Future plugin support will allow developers to create extensions using Rust and other supported languages.