smartem-workspace 0.1.0

CLI tool to automate SmartEM multi-repo workspace setup

smartem-workspace

CLI tool to automate SmartEM multi-repo workspace setup.

Installation

# Run directly with uvx (recommended)
uvx smartem-workspace init

# Or install globally
uv tool install smartem-workspace

Usage

Initialize a new workspace

# Interactive setup in current directory
smartem-workspace init

# Specify target directory
smartem-workspace init --path ~/dev/smartem

# Use a preset (skip repo selection)
smartem-workspace init --preset smartem-core

# Non-interactive with preset
smartem-workspace init --preset full --no-interactive

Available presets

Preset	Description
smartem-core	Core SmartEM repos (decisions, frontend, devtools)
full	All 30+ repos including ARIA reference
aria-reference	ARIA ecosystem repos for reference
minimal	Just smartem-devtools (workspace setup only)

Other commands

# Sync existing repos (git pull)
smartem-workspace sync

# Show workspace status
smartem-workspace status

# Add a single repo
smartem-workspace add DiamondLightSource/smartem-frontend

Options

--path PATH         Target directory (default: current directory)
--preset NAME       Use preset: smartem-core, full, aria-reference, minimal
--no-interactive    Skip prompts, use preset only
--ssh               Use SSH URLs (default: HTTPS)
--skip-claude       Skip Claude Code setup
--skip-serena       Skip Serena MCP setup

What it sets up

1. Repository clones - Organized by organization (DiamondLightSource, FragmentScreen, GitlabAriaPHP)
2. Claude Code configuration - Skills, settings, permissions
3. Serena MCP server - Semantic code navigation
4. Workspace structure - CLAUDE.md, tmp/, testdata/ directories

Documentation

• User Guide: Setup SmartEM Workspace
• Developer Guide: Contributing to smartem-workspace
• PyPI Setup: Publishing to PyPI
• API Documentation: SmartEM Devtools Docs

Development

cd packages/smartem-workspace

# Install dev dependencies
uv sync --all-extras

# Run tests
uv run pytest

# Run linter
uv run ruff check .

# Build package
uv build

See Developer Guide for detailed development instructions.

Releasing

Releases are published to PyPI via GitHub Actions using Trusted Publishers.

# 1. Update version in pyproject.toml
# 2. Commit the change
git commit -am "chore: release smartem-workspace vX.Y.Z"

# 3. Create and push a version tag
git tag smartem-workspace-vX.Y.Z
git push origin main --tags

The CI workflow runs tests, builds the package, and publishes to PyPI automatically on tag push.

Links

• PyPI: https://pypi.org/project/smartem-workspace/
• Repository: https://github.com/DiamondLightSource/smartem-devtools
• Issues: https://github.com/DiamondLightSource/smartem-devtools/issues
• Changelog: GitHub Releases

License

Apache-2.0